Creating a Gravity Forms form

  1. Log in to your WordPress website and go to Plugins in the left menu. Install the Gravity Forms plugin and the Gravity Forms Webhooks Add-On and activate both plugins.
  2. Go to Forms in the left menu and click Add New.
  3. Give the form a clear name and add at least an email field.
  4. Optionally adjust the button text, save the form and place it on the desired page.

You will use these names in the webhook later:

FieldName in the webhookRequired
Email addressemailYes
First namefirst_nameNo
Last namelast_nameNo

Connecting your Gravity Forms form to Xendy

  1. Log in to Xendy and go to All contacts via the left menu. Click New segment in the top right.
  2. Choose Manual, click Next, give the segment a title, and click Create segment. You'll be taken directly to the new segment.
  3. Click Add contacts in the top right and choose Via a webhook. A pop-up appears with sample code containing the webhook URL and your Authorization: Bearer token.
  4. In WordPress, go to Forms, select the correct form, go to Settings, and then to Webhooks.
  5. Add a new webhook that sends a POST request to the webhook URL. Add the Authorization value under Headers. Paste the full value including Bearer and a space, for example Bearer abc123.
  6. Include the form fields using exactly the names from the table above (email, first_name, last_name). If the email field in the webhook has a different name, Xendy will not create a contact.
  7. Click Save.

Adding contacts via a webhook is only available with an active subscription or during your trial period.

Want to send new subscribers a welcome email straight away? Link an Email automation with send type Immediately to this segment.

Testing the connection

  1. Go to the page on your website where the form is located.
  2. Fill in the form with a test email address (for example your own address).
  3. Log in to Xendy, go to All contacts and open the segment you created. Check whether the email address appears in the list.

Don't see the contact? Then check Settings → API, tab Activity (only for the Owner role). Select Incoming webhook and open the call to see what Xendy returned. A call with an incorrect token won't appear there: Xendy immediately rejects it with error code 401.

Adding extra fields

The email field is always required. For additional fields, use the following field names:

  • First name: first_name
  • Last name: last_name
  • Other fields: you can choose the name yourself

Additional fields are automatically added in Xendy and can then be used in segments or for personalization. Xendy converts the name to lowercase, replaces spaces with an underscore, and removes other characters: Company Name becomes company_name.

If the email address already exists in Xendy, the contact's details will be updated. A contact who had previously unsubscribed will be resubscribed.

Frequently asked questions

Yes, with the Xendy Connect plugin. It connects Gravity Forms directly to a list in Xendy, with a fixed step for consent and built-in spam protection; you don't need the Webhooks Add-On for this. You can download the plugin in Xendy at Settings → Webshop. That block appears when you've connected a WooCommerce store to Xendy. See Set up the Xendy Connect WordPress plugin.

Joeri Ras

Written by

Joeri Ras

Founder & co-owner @ Xendy

Prefer to talk directly?

Related articles

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
Integrations

Connect your WooCommerce store to Xendy

By connecting WooCommerce to Xendy, customer, order, and product data is synced daily. This lets you create segments based on purchase behavior, follow up on abandoned carts, and add personal product recommendations to your emails.

Read more