# Integrate with Onisend

{% stepper %}
{% step %}

#### Create Omnisend API Key

Follow this [guide](https://support.omnisend.com/en/articles/1061890-generating-api-key) to access and manage your API keys for your Omnisend account.

> **Note:** Ensure you create a valid API key, as it’s required to connect the app to your Omnisend account.
> {% endstep %}

{% step %}

#### Add API Key to the App

* From the **App Admin** page, go to **Settings > Integration**.
* Locate **Omnisend** and click the **gear icon** to configure.
* In the **Omnisend API Key** field, paste the key you generated in Step 1.
* Click **Save** to apply the changes.

<figure><img src="/files/EkEaLqTzyORfMMcvn9ly" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Connect Form Elements to Omnisend Subscriber Fields

* Tick the checkbox to **Enable** the integration.
* For each field, enter the corresponding form value (on the right) to match it with the correct Omnisend field.

<figure><img src="/files/osqK4UeJyZi6qEnt42GW" alt="" width="375"><figcaption></figcaption></figure>

For example:

* Match **First name** from your form to **First name** in Omnisend.
* Match **Last name** from your form to **Last name** in Omnisend.

Click **Save** to update the configuration.
{% endstep %}

{% step %}
Submit a form to test. Then, check **Audience > Contact list** in Omnisend to verify if the new contact has been added.

**Important:**

* **Email** is required to create a new profile in Omnisend.
* Other fields are optional and can be mapped as needed.
  {% endstep %}
  {% endstepper %}

***

#### 📩 Need Help?

If you encounter any difficulties during setup, please don’t hesitate to reach out via **chat** or email us at **<hi@globosoftware.net>**. We're always here to help!


---

# 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.globo.io/pre-order/integrations/third-party-integration/integrate-with-onisend.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.
