Developers

Integrate once. Send through any provider.

Send email, sync contacts and manage suppressions through our APIs. Switch or combine ESPs without touching your code, and get the same webhook events from all of them.

Read the API docs ↗ Get an API key

# Send one email through your relay
POST https://transactional.emailelement.com/api/Email
x-api-key: YOUR_API_KEY

{
  "to": { "name": "Jane Smith", "email": "jane@example.com" },
  "subject": "Your Order Confirmation",
  "htmlBody": "<h1>Hello {firstName}!</h1>",
  "transactionRelayId": 2,
  "substitutions": { "firstName": "Jane" }
}

Transactional Email API

One email per call, with templates, Handlebars-style substitutions, attachments up to 20 MB, a delay of up to about 12 hours, and five tracking IDs echoed back in webhooks.

POST transactional.emailelement.com/api/Email

API reference ↗

Contact API

Add or update contacts in a list. Existing contacts are updated when you ask, and you can require fields. If more than 10% of a batch fails, the whole request is rejected.

POST /api/contactList/{listId}/Contacts

API reference ↗

Suppression API

Add up to 10,000 records per call, remove records, or request a ZIP download of a whole list.

POST /api/SuppressionList/{listId}/Records

API reference ↗

Webhooks

JSON posted to your HTTPS endpoint, with retries. The payload names the ESP, send integration, sender domain and content.

SubmittedInitiatedSentSoftBouncedHardBouncedComplainedSuppressedUnsubscribedOpenedClickedFailedRetryPausedCanceled

Webhook guide ↗

Authentication

One key, permissions per API

Every request sends an x-api-key header. Each key gets None, Read Only or Full Access for each API, so a form backend never needs your suppression rights.

// Webhook payload (trimmed)
{
  "type": "Clicked",
  "messageId": "84213907",
  "recipient": "jane@example.com",
  "esp": "SendGrid",
  "sendIntegration": { "name": "Production SendGrid" },
  "senderDomain": { "domain": "mail.yourdomain.com" },
  "source": "April Newsletter [Scheduled Email]"
}

Get an API key in minutes

Start sending Book a demo

Name	Set by	What it does	Lasts
ee_website_visitor	EmailElement	Limits how many messages one browser can send to our chat assistant, Eli	1 year
ee_cookie_consent	EmailElement	Remembers your cookie choices	1 year
__cf_bm	Cloudflare	Tells people apart from bots, so Cloudflare can block automated traffic. It holds no personal data.	30 minutes

Name	Set by	What it does	Lasts
_ga	Google	Tells one browser's visits apart from another's	2 years
_ga_<id>	Google	Keeps track of the current visit	2 years

Name	Set by	What it does	Lasts
_gcl_au	Google	Links a Google Ads click to a sign-up, so we can see which ads lead to new accounts	90 days
_gcl_ls	Google	Keeps the Google Ads click details in browser storage when the cookie cannot be set	90 days
IDE	Google	Shows our ads to people who visited this website, on other sites in Google's ad network	13 months
_uetsid	Microsoft	Links a Microsoft Advertising click to what you do on this visit	1 day
_uetvid	Microsoft	Recognizes a returning visitor, so Microsoft Advertising can credit a sign-up to an earlier ad click	13 months
MUID	Microsoft	Identifies your browser across Microsoft sites, used by Microsoft Advertising	13 months
_fbp	Meta	Recognizes your browser, so Meta can credit a sign-up to an ad on Facebook or Instagram and show our ads to past visitors	90 days
_rdt_uuid	Reddit	Recognizes your browser, so Reddit can credit a sign-up to an ad on Reddit	90 days
bcookie	LinkedIn	Identifies your browser to LinkedIn, used by the LinkedIn Insight Tag	1 year
UserMatchHistory	LinkedIn	Matches your visit to your LinkedIn profile, so LinkedIn can credit ads and show our ads to past visitors	30 days
ee-ad-source	EmailElement	Remembers the ad that brought you here, so a new account can be credited to it. Kept in browser storage rather than a cookie.	90 days

Integrate once. Send through any provider.

APIs and webhooks

Transactional Email API

Contact API

Suppression API

Webhooks

One key, permissions per API

Get an API key in minutes