If you want to integrate Omnisend with another software (e.g., third-party contact form), you can pass data to Omnisend (or get data) via our API. With every request, we require using an API key for authorization purposes.
Creating an API key
You can create an API key by going to Store settings in your Profile menu → Integrations & API → API key → click Create an API key.
Enter the name for your API key and choose the permissions it should have. There are two main options:
1. This API key will only allow adding new subscribers. This permission allows:
To add new subscribers (using this API call).
This type is sufficient when you only want to connect your site with your Omnisend account.
2. Setting up custom permissions for this API key. The permission allows to access this data:
Campaigns (allows to download reports, list of recipients)
Contacts (allows to create, edit, download, and delete subscribers)
Orders (allows to create, edit, download, and delete orders)
Products (allows to create, edit, download, and delete products)
Carts (allows to create, edit, download, and delete carts)
Events (allows to trigger and get custom events for custom automations)
These additional permissions are helpful when you're doing an extensive integration of Omnisend to your store, not just integrating a third-party tool for a particular feature. To learn more about API integration, see our documentation.
You can change these permissions any time in the future.
Permissions are created to assure your API key only passes through the information you want and does not abuse your integration. You can create a different combination of the permissions, for example, a key that has access only to Contacts' data and cannot reach Products or Campaigns.
That's it. You have created an API key.
If you decide any changes are needed to the permissions of a particular API key, keep in mind that it takes up to 5 minutes for those changes to reflect.
Helpful resource - Full Omnisend API documentation.
