Create a webhook URL in Xendy

  1. Log in to Xendy and select All contacts from the left menu. Click New segment in the top right.
  2. Choose Manual and click Next.
  3. Give the segment a title and click Create segment. You'll be taken directly to the new segment.
  4. Click Add contacts in the top right and choose Via a webhook.
  5. A pop-up opens with example code containing the webhook URL and your Authorization: Bearer token. Save these details, as you'll need them in Zapier.

Note: make sure you copy the webhook secret correctly. An invalid or empty secret is immediately rejected with an HTTP 401 error. The secret never appears in error messages or logs, so double-check it before setting up the connection in Zapier.

Adding contacts via a webhook is only available with an active subscription or during your trial period. Without a subscription, Xendy displays a message to upgrade and the webhook rejects the request with error code 403.

Set up Zapier

  1. Go to zapier.com and create an account.
  2. Choose a paid plan — webhooks are only available on paid plans.
  3. Log in and click Create Zap.

Create a Zap

Setting up the trigger

  • Choose the app where your data comes from (e.g. Google Forms or Shopify).
  • Select the event that starts the Zap (e.g. new submission or new order).
  • Test the connection so Zapier can retrieve sample data.

Setting up the action

  • Choose Webhooks by Zapier as the action app.
  • Select POST as the method.
  • Paste the webhook URL you created in Xendy.
  • Set the type to JSON.
  • Under Custom Request Headers, add the token: Authorization: Bearer abc123 (use your own full token). The value always starts with Bearer followed by a space.

Mapping fields

  • Link the fields from your app to Xendy.
  • email is required.
  • Use first name as first_name and last name as last_name (both optional).

Testing

  • Send test data from Zapier.
  • Check in Xendy (All contacts → your segment) whether the data came through correctly.
  • Nothing coming in? Go to Settings → API → Activity (Owner role only) to see every call under Incoming webhook along with Xendy's response.

Activating the Zap

  • Is the test working correctly? Then click Turn on Zap.
  • New submissions will now automatically appear in Xendy.
  • Want to send new contacts a welcome email right away? Link an Email automation with send type Immediate to the segment.

Add extra fields

FieldField nameRequired
Email addressemailYes
First namefirst_nameNo
Last namelast_nameNo
Other fieldsyour choiceNo

You can name other fields yourself. They are automatically added in Xendy and can then be used in segments or personalization. Xendy converts field names to lowercase, replaces spaces with an underscore, and removes other characters. Xendy does not store nested fields (objects or lists): send each field as a separate value.

Frequently asked questions

If the email field is missing from your JSON payload or does not contain a valid email address, the webhook request will fail (Xendy responds with customer:invalid-email) and no contact will be added to Xendy. Always make sure the email field is included and correctly mapped.

If you send an email address that already exists in Xendy, Xendy will update that contact's details and add it to your segment. If the contact had previously unsubscribed, it will be resubscribed. So only send through contacts who have given their permission.

Yes. In Xendy, go to Blocked contacts, click New segment, and create a block list using Block manually. In that list, click Add blocked contacts and choose Via a webhook. Use that webhook URL in your Zap: every email address you send will be unsubscribed from all your emails.

Joeri Ras

Written by

Joeri Ras

Founder & co-owner @ Xendy

Prefer to talk directly?

Related articles

Integrations

Connect Gravity Forms to Xendy

With Gravity Forms you can easily create forms in WordPress. By connecting it to Xendy, submissions automatically end up in a static segment, so you can use new contacts right away for newsletters or email automations.

Read more
Integrations

Connect your Lightspeed store to Xendy

By connecting Lightspeed to Xendy, customer, order, and product data are automatically synchronized every night. This allows you to create segments based on purchasing behavior and display products directly in your emails. With two scripts in your webshop, you can also follow up on abandoned shopping carts.

Read more
Integrations

Connect your Magento 2 store to Xendy

By connecting Magento 2 to Xendy, customer, order and product data are automatically synchronized every night. This allows you to create segments based on purchasing behavior, display personal product recommendations and follow up on abandoned shopping carts. Please note: abandoned shopping carts only work in Magento 2 for customers who are logged in to your webshop. Xendy retrieves them during the nightly import.

Read more
Integrations

Connect your Shopify store to Xendy

By connecting Shopify to Xendy, your customers, orders, and products will be available in Xendy. This allows you to create segments based on purchasing behavior and add products to your emails. You can connect via the Xendy app in Shopify or with a custom app from the Shopify Dev Dashboard. With the Xendy app, changes come in immediately, abandoned carts work, and unsubscribes sync both ways. With a custom app, your data is updated every night.

Read more