Email Marketing

Quick start

Sync audiences and contacts from your app, automation, or AI agent. Keys belong to a signed-in organization. There is no anonymous write access.

Base URL

Production requests go to https://api.thealtermeai.com. Every email path starts with /api/v1/email.

Send one contact

Create a key in Workspace → API keys after you sign in, then upsert a contact into an audience you already have.

curl

curl -sS https://api.thealtermeai.com/api/v1/email/contacts \
  -H "Authorization: Bearer emk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","audienceId":"YOUR_AUDIENCE_ID","firstName":"Ada"}'

A new email returns 201. The same email again updates that contact and returns 200. Read Authentication before you store a key, and Contacts for fields and consent status.

CSV in the app

A spreadsheet can stay in the product. On an audience, Add members → Import CSV maps columns to email, name, and custom attributes before anything is stored. The API is the path for code and agents.

Imports finish even when many rows already exist on the list or contain bad addresses — only those rows are skipped. See Contacts → Re-imports and partial success for the full rules (duplicates, consent, unsubscribe).