# Omnisend integration

### 📝 Steps 1: Generating API Key

PowerfulForm 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., "Globo Form Integration") 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)

***

### 📝 Step 2: Add Omnisend API Key to the app settings (in PowerfulForm)

Now connect Omnisend inside Powerful Form.

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

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FIScrx7CjxbYY6bkDEHaV%2F2025-10-07_14-33-48.png?alt=media&#x26;token=fdfbec74-fd8d-46f3-a6fa-3188e5700146" alt=""><figcaption></figcaption></figure>

***

### 📝 Step 3: 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://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FXwUQFiTUuVsuWtiwIQQx%2F2026-01-30_16-55-58.png?alt=media&#x26;token=1d95c526-3567-4658-bfe7-0acd7baa5fce" alt=""><figcaption></figcaption></figure>

3. Map your fields. For example:

* &#x20;**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://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FIJtf4Dgy6sSgBEpuzs5M%2F2026-01-14_16-06-27.png?alt=media&#x26;token=87cc68c4-dedb-44a0-9ebf-46357960012a" alt=""><figcaption></figcaption></figure>

4\. Click **Save** to update the changes.

***

### ✅ 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://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FkCqGqBb62lxpCWuXTFie%2F2026-01-14_16-10-23.png?alt=media&#x26;token=3bea8d1e-6420-4e0c-b494-f1256792a78a" alt=""><figcaption></figcaption></figure>

***

### 🔧 **Troubleshooting**

#### &#x20;“Invalid API key” / cannot connect

* Make sure you copied the API key from **My Account → API Keys** in Omnisend.&#x20;
* Remove any extra spaces before/after the key.
* Crea**te a new API key in Omnisend and replace it in PowerfulForm if the old one was revoked.**

#### Contacts are not being added after submission

* 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.

#### Some fields are blank in Omnisend

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

***

#### Need More Help?

If you still need assistance, please contact us at [**support@powerfulform.com**](mailto:support@powerfulform.com). Our team will be happy to help you resolve any issues or guide you further.<br>