> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/integrations/omnisend.md).

# Omnisend integration

Add form respondents to Omnisend as contacts and map their answers to contact fields.

## How to set it up

{% stepper %}
{% step %}

### Generating API Key

Powerful Contact Form Builder needs an **Omnisend API Key** to connect securely to your account.

#### How to generate an Omnisend API key

1. Log in to your **Omnisend** account > navigate to **My Account** > **API Keys**.
2. Click **Create API Key** > enter a name for your API key (e.g., "Powerful Contact Form Builder") and click **Save**.
3. Copy the generated API key for use in the next step.

For detailed instructions, refer to Omnisend's official guide: [How to create an API key](https://support.omnisend.com/en/articles/1061890-generating-api-key)
{% endstep %}

{% step %}

### Add Omnisend API Key to the app settings (in Powerful Contact Form Builder)

Now connect Omnisend inside Powerful Contact Form Builder.

1. Open the app > click **Settings > Third party integrations** > hover **Omnisend** > click **Config**
2. Enter **Omnisend API key** field created in the **Step 1** above
3. Click **Save** to update the changes

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-9b8fcc75a2a4206cb2a42f760acc1a6fe14657d2%2Fscreenshot-integration-omnisend-integration-1.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Connect form data to Omnisend (in Form Builder)

This step decides:

* which Omnisend audience/list receives the contact
* how your form fields map to Omnisend contact fields

1\. Open the app > click **Forms** > open the form you want to deal with

2\. Click **Integration** icon on the left side > enable **Omnisend** > click on **Omnisend** option

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-f9418fbb4fdc11ec6fe0dc49e65a19312267c3eb%2Fscreenshot-integration-omnisend-integration-2.png?alt=media" alt=""><figcaption></figcaption></figure>

3. Map your fields. For example:

* **Email** ← your form’s Email field
* **First name / Last name** ← your form’s name fields
* 📱**Phone** (optional) ← your form’s phone field

⭐ **Important:** Always map **Email** if you want Omnisend to create/update a contact reliably.

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-8bab01abf4e6b45cba1b37b3b2509cf05e31720c%2Fscreenshot-integration-omnisend-integration-3.png?alt=media" alt=""><figcaption></figcaption></figure>

4\. Click **Save** to update the changes.
{% endstep %}

{% step %}

### Test & Check Your Results (in Omnisend)

1. Submit the form once (use a real email for testing)
2. Open **Omnisend**
3. Go to **Audience / Contacts**
4. Confirm the new contact appears (and fields are filled correctly)

<figure><img src="https://2907469752-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FehM2rz7MmKkWcJmgvJOe%2Fuploads%2Fgit-blob-c9149060a0e898aaba96ceccc9c18e30c992c120%2Fscreenshot-integration-omnisend-integration-4.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Troubleshooting

<details>

<summary>“Invalid API key” / cannot connect</summary>

* Make sure you copied the API key from **My Account → API Keys** in Omnisend.
* Remove any extra spaces before/after the key.
* **Create a new API key in Omnisend** and replace it in Powerful Contact Form Builder if the old one was revoked.

</details>

<details>

<summary>Contacts are not being added after submission</summary>

* Confirm Omnisend is enabled on the correct form.
* Make sure you clicked Save after mapping.
* Submit a new test entry (old submissions won’t sync automatically).
* Ensure the submission contains a valid email address.

</details>

<details>

<summary>Some fields are blank in Omnisend</summary>

Re-check mapping (example: “Full name” mapped into “First name” may not display as expected).

</details>

<br>

## Next steps

* [How integrations work](/integrations/how-integrations-work.md) — what a connection does and where it is configured.
* [Integrations](/integrations/app-integration.md) — every service the app connects to.
* [Contact support](/help/contact-support.md) — if the connection still does not work.