Get started

EmailMarketer.io developer docs

Send transactional email, manage contacts, lists and campaigns, and connect AI assistants to your EmailMarketer.io account through the API.

EmailMarketer.io has an HTTP API for everything you do in the app: contacts, lists, segments, campaigns, journeys, sender domains and transactional email. This page shows the two kinds of API key, the request format, and your first calls.

Two ways in

You want to Use Key
Send one transactional email from your app POST /api/v1/email or SMTP Sender API key of a sending domain
Manage contacts, lists, campaigns and journeys Account API commands Account API key

Both run on https://app.emailmarketer.io. Authentication explains where to create each key.

The examples in these docs read the account API key from the EM_API_KEY environment variable and the sender API key from EM_SENDER_KEY. Set them before you run an example, for example export EM_API_KEY=your-key.

Request format

Account API commands are named like subscriber.create. Send the command name in Command and your key in APIKey, as form fields or as a JSON body:

curl https://app.emailmarketer.io/api.php \
  -d Command=lists.get \
  -d APIKey="$EM_API_KEY"

Many commands also have their own path under /api/v1/. The same call to /api/v1/lists.get works the same way. Each reference page shows the path when one exists. When a command has no path of its own, use /api.php.

Responses are JSON. A successful legacy command looks like this:

{ "Success": true, "ErrorCode": 0, "ErrorText": "", "Lists": [ ... ] }

Errors and status codes covers the error formats.

Quickstart: add a contact

  1. Create an account API key in the app.
  2. Find the ID of a list with lists.get (above).
  3. Add a contact:
curl https://app.emailmarketer.io/api.php \
  -d Command=subscriber.create \
  -d APIKey="$EM_API_KEY" \
  -d ListID=123 \
  -d EmailAddress=jane@example.com \
  -d SubscriptionDate="2026-11-17 09:30:00" \
  -d SubscriptionIP=203.0.113.10

The response carries the new contact’s ID:

{ "Success": true, "ErrorCode": 0, "SubscriberInformation": { "SubscriberID": 456, "EmailAddress": "jane@example.com", "SubscriptionStatus": "Subscribed" } }

Quickstart: send a transactional email

  1. Verify a sending domain in the app.
  2. Create a sender API key for that domain under Transactional, on the domain’s API keys tab.
  3. Send:
curl -X POST https://app.emailmarketer.io/api/v1/email \
  -H "Authorization: Bearer $EM_SENDER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "From": { "name": "Acme", "email": "no-reply@acme.com" },
    "To": [{ "name": "Jane", "email": "jane@example.com" }],
    "Subject": "Reset your password",
    "ContentType": "html",
    "HTMLContent": "<p>Click the link to reset your password.</p>"
  }'
{ "MessageID": "550e8400-e29b-41d4-a716-446655440000" }

Send email lists every field.

Where to go next

  • Webhooks: get delivery, bounce, open, click and unsubscribe events for transactional email.
  • AI assistants (MCP): connect Claude, ChatGPT and other assistants to your account.
  • The API reference in the menu: one page per area, with every parameter and error code.