# Omnisend integration

💳 **Paid plan required:** Omnisend integration is available on **paid plans only**.

### 🔑 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.

**✅ Steps**

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="/files/X6uZFpUjA5i7oLI80CDO" 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="/files/hdNZv385MizLkj7Iwfqc" alt=""><figcaption></figcaption></figure>

3. Select the Omnisend **List**/**Audience** you want to add contacts to
4. 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://da76v9kevdkud.cloudfront.net/wp-content/uploads/2022/07/Monosnap-STAFFPowerful-Contact-Form-Builder-2024-10-30-08-46-06-1024x614.png" 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="/files/u8tDPC558llwDV10W1LM" alt=""><figcaption></figcaption></figure>

***

### **🛠️ Troubleshooting**

#### 🔒 “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).

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powerfulform.com/~/revisions/KRfi0fHdeAFeAhiPrH7G/app-integration/omnisend-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.