Elastic Email API

Name: Elastic Email API
Brand: Elastic Email API
Availability: InStock

✓ Official Vendor SpecCommunicationsEmail DeliveryapiKey15 EndpointsREST

For Agents

Send transactional or bulk emails, manage campaigns, contacts, and lists, and pull delivery statistics from Elastic Email.

Install Jentic One Beta

Connect the Elastic Email API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Elastic Email API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Elastic Email API.

Send a single transactional email or a bulk send across many recipients

Create, load, update, and delete email campaigns by name

Add contacts, list contacts, and remove contacts by email address

GET STARTED

Start building with Elastic Email API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Elastic Email API for, with concrete tasks.

★ Transactional email delivery from a SaaS app

A SaaS application sends password resets, receipts, and invitations through Elastic Email. POST /emails handles individual sends, while POST /emails/transactional supports bulk transactional jobs. With a single API key, the integration is straightforward enough to wire in during a single sprint and reliable for production traffic.

POST /emails with the recipient, subject, and HTML body, then check the delivery status via GET /statistics.

Marketing campaign automation

A marketing team manages email campaigns from a custom admin tool. POST /campaigns creates a campaign, PUT /campaigns/{name} updates it, and GET /campaigns lists the existing ones. Combined with /lists for audience segments and /templates for content reuse, the Elastic Email API supports a self-serve campaign workflow without leaving the admin tool.

POST /campaigns to create a campaign, then PUT /campaigns/{name} to update its template before send.

Contact-list synchronisation from a CRM

A CRM-driven team needs Elastic Email contacts to mirror their CRM segments so newsletters target the right audience. A scheduled job uses GET /contacts and POST /contacts to add and verify contacts, and GET /lists plus POST /lists to keep audience definitions in sync. DELETE /contacts/{email} handles unsubscribes coming back from the CRM.

Diff the CRM segment against GET /contacts results, then POST /contacts for new entries and DELETE /contacts/{email} for removed entries.

Email-sending agent through Jentic

An agent platform exposes 'send an email' as a tool. Through Jentic, the agent searches by intent, receives the Elastic Email POST /emails operation, and executes it with the API key Jentic injects at runtime. The agent never sees the raw key and does not need to choose between 15 endpoints by hand.

Search Jentic for 'send a transactional email with Elastic Email', load the POST /emails schema, and execute with the recipient and content captured by the agent.

Key Endpoints

15 endpoints — elastic email is a transactional and marketing email delivery service, and the v4 api exposes 15 endpoints covering single and bulk email send, campaign creation and management, contact and list management, statistics, and template retrieval.

METHOD

PATH

DESCRIPTION

POST

/emails

Send an email

POST

/emails/transactional

Send a bulk transactional email

POST

/campaigns

Create a campaign

PUT

/campaigns/{name}

Update a campaign

GET

/contacts

List contacts

POST

/contacts

Add a contact

GET

/statistics

Load delivery statistics

GET

/templates

List templates

POST

/emails

Send an email

POST

/emails/transactional

Send a bulk transactional email

POST

/campaigns

Create a campaign

PUT

/campaigns/{name}

Update a campaign

GET

/contacts

List contacts

POST

/contacts

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Elastic Email API keys are stored encrypted in the Jentic vault (MAXsystem). Jentic injects the X-ElasticEmail-ApiKey header at execution time, so the raw key never enters the agent's context — the agent only ever has scoped execution access.

Intent-based discovery

Agents search Jentic by intent — 'send a transactional email', 'create an email campaign', 'add a contact to my list' — and Jentic returns the matching Elastic Email operation along with its input schema.

Time to first call

Direct integration: 1-2 days for a single-API-key client and basic error handling. Through Jentic: under 30 minutes — search, load schema, execute.

FAQs

Specific to using Elastic Email API through Jentic.

What authentication does the Elastic Email API use?

Elastic Email uses an API key passed in the X-ElasticEmail-ApiKey header on every request. Jentic stores the key encrypted in its vault and injects the header at execution time so the agent never sees the raw secret.

Can I send transactional and bulk emails through the API?

Yes. POST /emails sends a single email and POST /emails/transactional sends a bulk transactional payload. Both endpoints accept HTML and plain-text bodies plus per-recipient merge fields.

How do I manage campaigns through the API?

POST /campaigns creates a campaign, GET /campaigns lists them, GET /campaigns/{name} loads a single campaign, PUT /campaigns/{name} updates it, and DELETE /campaigns/{name} removes it. Campaigns are addressed by name in this spec.

What are the rate limits for the Elastic Email API?

Rate limits are not declared in the OpenAPI spec and depend on the Elastic Email plan and reputation tier. Use bulk endpoints for batches rather than sending one /emails request per recipient, and back off on 429 responses.

How do I send an email through Jentic?

Install the SDK with pip install jentic, search Jentic for 'send a transactional email with Elastic Email', load the POST /emails schema, and execute with the recipient, subject, and body. Jentic injects the X-ElasticEmail-ApiKey header so the agent only handles scoped execution.

Can I read delivery statistics with this API?

Yes. GET /statistics returns delivery statistics for the account; combine it with the campaigns and contacts endpoints to attribute deliverability back to specific sends.

Elastic Email API

Connect the Elastic Email API to your agent

Capabilities

Start building with Elastic Email API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs