1. Log in to your Omnisend account

If you don’t have an account, create one on Omnisend website.

2. Create API Key

Navigate to the Api Keys section of your Omnisend account.

Click Create API key and give it a descriptive name that will remind you which application it’s used for.
Copy the generated key immediately and store it in a secure location. You won’t be able to see or copy the key once you finish generating it.

Read more about API Keys in our knowledge base.

3. Sending First API Request

Now that you have the API key you can try creating your first contact via API.

In the code below replace YOUR-API-KEY with your actual key.

It will create a contact that is subscribed via hello@example.com email.

curl --request POST \
     --url https://api.omnisend.com/api/contacts \
     --header 'Authorization: Omnisend-API-Key YOUR-API-KEY' \
     --header 'Omnisend-Version: 2026-03-15' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "identifiers": [
    {
      "type": "email",
      "channels": {
        "email": {
          "status": "subscribed",
          "statusDate": "2023-01-01T10:07:28Z"
        }
      },
      "id": "hello@example.com"
    }
  ]
}
'

Next Actions

Now you can start creating integration to:

Sync contacts
Send order, cart or any custom event to trigger automations
Trigger campaigns programmatically.
and more.

For this and more functionality check API reference in the sidebar or check our Postman collection.

Need help?

Don't be afraid to contact us. We are always ready to help!