# Omnisend

### Connection <a href="#connect" id="connect"></a>

When you're setting up your first workflow with Omnisend, you'll need to add your **API key** so that Omnisend is a connected app within MESA.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FrmrrU58cD1uXJJJeA7nt%2Fimage.png?alt=media&#x26;token=cc59a210-b294-410f-a65c-f6999992e9ae" alt=""><figcaption></figcaption></figure>

To get an API key:

1\. [Login into your Omnisend account.](https://app.omnisend.com/login)

2\. Once logged in, head over to Omnisend's App Market to connect MESA and Omnisend by clicking on this link in a new tab: <https://appmarket.omnisend.com/app-details/62a2fdd615a109001b4d9757>

3\. Click on the Connect now button.

4\. On the next screen, click on the Copy API Key button.

5\. Go back into your MESA workflow that contains an Omnisend step. Paste the copied values into the Omnisend API Key field.

6\. After pasting, click on the Add Connection button.

7\. Now go back to the tab with the MESA page in the Omnisend App Market. Click on the checkbox next to I have completed all the steps and on the Confirm button.

### Configure <a href="#configuring" id="configuring"></a>

When using the Omnisend Update/Create Contact [actions](https://docs.getmesa.com/workflow-builder/actions), there is a section for Custom Properties.

1. Select More options, scroll down to the Custom Properties, then click both the Key and Value checkboxes.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FYYMCt9uDe7BZFLDz1ip2%2FSet%20Up%20Custom%20Properties%20in%20Omnisend-MESA%20Integration%20-%20Step%202.png?alt=media&#x26;token=3ee2cd42-c230-40cf-869c-750406beeae8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FM2saLDC6UgjMc8GnGUJE%2FSet%20Up%20Custom%20Properties%20in%20Omnisend-MESA%20Integration%20-%20Step%203.png?alt=media&#x26;token=94d52e46-dbd5-4c6b-b570-dbccb67d8cd2" alt=""><figcaption></figcaption></figure>

2. You can click on Add to add more custom properties that will be added to the Contact in question. Also, you can utilize [MESA's Variables feature](https://docs.getmesa.com/workflow-builder/fields/variables) to send custom data from other integrations.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FMtuoQCQSSfeqDKWGIX1n%2FEF-omnisend-add-custom-properties.png%20-%20Step%202.png?alt=media&#x26;token=a91e1e25-0833-4542-b678-b8a4471a7688" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FJEUQjIXHQl3XjqrSFkmT%2FSet%20Up%20Custom%20Properties%20in%20Omnisend-MESA%20Integration%20-%20Step%204.png?alt=media&#x26;token=ee835577-7768-41de-a5a4-64c7077b4ad5" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**🗒 Note**: The **Key** can be named anything as you'd like, but cannot include spaces. As a good rule, you should make the **Key** specific to the data sent to Omnisend.
{% endhint %}

### I don't see my Omnisend workflow activating when I update something in Omnisend? <a href="#trigger" id="trigger"></a>

MESA workflows that contain Omnisend [triggers](https://docs.getmesa.com/workflow-builder/triggers) (such as Order Created) will run on a polling system. Meaning, on every hour or whatever the selected frequency is selected in your MESA workflow, MESA will look for any recent activity in Omnisend. As a result, you may not see immediate activity in your MESA workflow until the frequency hits.

In Onmisend triggers, you can find the polling system within More options. You can keep the default frequency or adjust it.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2FYx0RI30rkvbwFK9Hbkmw%2FEF-omnisend-schedule.png%20-%20Step%202.png?alt=media&#x26;token=97911532-f4f4-4179-9a08-aa84e133307d" alt=""><figcaption></figcaption></figure>

Once the frequency hits, MESA will process every single task that has accrued within the previous timeframe.

{% hint style="info" %}
**🗒 Note**: Please note that available frequencies will differ depending on your MESA billing plan.
{% endhint %}
