Omnisend

The Omnisend modules allow you to search, list, retrieve, create, update, and delete the contacts, and events in your Omnisend account.

Getting Started with Omnisend

Prerequisites

An Omnisend account

In order to use Omnisend with Integromat, it is necessary to have an Omnisend account. If you do not have one, you can create an Omnisend account at omnisend.com.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Omnisend to Integromat

To connect your Omnisend account to Integromat you need to obtain the API Key from your Omnisend account and insert it in the Create a connection dialog in the Integromat module.

1. Log in to your Omnisend account.

2. Click Your Profile Icon > Store Settings > Integrations & API > API Keys > Create API Key.

3. Enter the name for the API Key, select the permissions, and click Save.

4. Copy the API Key to your clipboard.

5. Go to Integromat and open the Omnisend module's Create a connection dialog.

6. In the Connection name field, enter a name for the connection.

7. In the API Key field, enter the API key copied in step 4, and click Continue.

The connection has been established.

Events

Trigger a Custom Event

Triggers a custom event in Omnisend.

Connection	Establish a connection to your Omnisend account.
Event ID	Select the Event ID you want to watch.
Email	Enter the email address of the contact whose events you want to watch.
Phone	Enter the contact's phone number whose events you want to watch.

Get a Custom Event

Retrieves information about a custom event.

Connection	Establish a connection to your Omnisend account.
Event ID	Select the Event ID whose details you want to retrieve.

List Custom Events

Returns a list of custom events.

Connection	Establish a connection to your Omnisend account.
Limit	Set the maximum number of events Integromat should return during one scenario execution cycle.

Create a Custom Event

Creates a custom event.

Connection Establish a connection to your Omnisend account.

Name Enter the event name.

System Name Enter the event name in the system.

Email Enter the contact email address for the event. You must mention either an email address or a phone number to create the event.

Phone Enter the contact phone number for the event. You must mention either an email address or a phone number to create the event.

Custom Properties

Add the custom properties for the event:

Name	Enter the custom property name. For example, `company`.
Type	Select the value type. For example, `text`.
Value	Enter the custom property value. For example, `company name`.

Contacts

Create a Contact

Creates or updates a subscriber with all provided values, i.e. name, phone number, tag, etc.

Connection Establish a connection to your Omnisend account.

First Name Enter the contact's first name.

Last Name Enter the contact's last name.

Tags Add the tags for the contact separated by a comma.

Identifiers

Add the identifiers for the contact:

Type	Select the identifier type: Email Phone
Channel Status	Select whether the contact's email address or phone number is subscribed.
Status Date	Enter the date when the email address or phone status of the contact last checked.
Email	Enter the contact's email address.
Phone Number	Enter the contact's phone number.
Source	Enter the source details from where you have received the contact information. For example, `webinar`.
Send Welcome Message	Select the checkbox to send a welcome email or SMS to the contact.

Search Contacts

Searches for contacts.

Connection	Establish a connection to your Omnisend account.
Limit	Set the maximum number of contacts Integromat should return during one scenario execution cycle.
Email address	Enter the contact's email address whose details you want to search.
Status	Select the status to search the contacts with the specified status. For example, `subscribed`.
Segment ID	Enter the Segment ID to search the contacts with the specified segment.
Phone	Enter the phone number to search the contacts with the specified number.

Update a Contact

Updates a contact module.

Connection Establish a connection to your Omnisend account.

Contact ID Select the Contact ID whose details you want to update.

First Name Enter the contact's first name.

Last Name Enter the contact's first name.

Tags Add the tags for the contact separated by a comma.

Identifiers

Add the identifiers for the contact:

Type	Select the identifier type: Email Phone
Channel Status	Select whether the contact's email address or phone number is subscribed.
Status Date	Enter the date when the email address or phone status of the contact last checked.
Email	Enter the contact's email address.
Phone Number	Enter the contact's phone number.
Source	Enter the source details from where you have received the contact information. For example, `webinar`.
Send Welcome Message	Select the checkbox to send a welcome email or SMS to the contact.

Get a Contact

Retrieves information about a specific contact.

Connection	Establish a connection to your Omnisend account.
Contact ID	Select the Contact ID whose details you want to retrieve.

Other

Make an API Call

Performs an arbitrary authorized API call.

Connection	Establish a connection to your Omnisend account.
URL	Enter a path relative to `https://api.omnisend.com/`. For example: `/v3/contacts` For the list of available endpoints, refer to the Omnisend API Documentation.
Method	Select the HTTP method you want to use: GET to retrieve information for an entry. POST to create a new entry. PUT to update/replace an existing entry. PATCH to make a partial entry update. DELETE to delete an entry.
Headers	Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String	Enter the request query string.
Body	Enter the body content for your API call.