Skip to main content
POST
/
v1.EmailService
/
SendEmail
Send an email.
const options = {
  method: 'POST',
  headers: {
    'Connect-Protocol-Version': '<connect-protocol-version>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    from: '<string>',
    to: ['<string>'],
    cc: ['<string>'],
    bcc: ['<string>'],
    subject: '<string>',
    body: JSON.stringify('<string>'),
    html: '<string>',
    metadata: {},
    scheduledAt: '2023-11-07T05:31:56Z',
    attachments: [{base64Content: '<string>', filename: '<string>', contentType: '<string>'}],
    inReplyTo: '<string>',
    references: ['<string>'],
    replyTo: '<string>'
  })
};

fetch('https://api.simpleemailapi.dev/v1.EmailService/SendEmail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "<string>",
  "status": "EMAIL_STATUS_UNSPECIFIED",
  "statusMessage": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key authentication. Get your API key from the SimpleEmailAPI dashboard and include it in the Authorization header as: Bearer sea_live_xxxxx

Headers

​
Connect-Protocol-Version
enum<number>
required

Define the version of the Connect protocol

Available options:
1
​
Connect-Timeout-Ms
number

Define the timeout, in ms

Body

application/json

Request to send an email.

​
from
string

Verified sender email address (e.g., "notifications@yourdomain.com").

​
to
string[]

Primary recipients.

​
cc
string[]

Carbon copy recipients.

​
bcc
string[]

Blind carbon copy recipients.

​
subject
string

Email subject line.

​
body
string

Plain text content. Always recommended for better deliverability.

​
html
string

HTML content.

​
metadata
metadata · object

Custom metadata to track this email. These values are returned in webhooks and events.

​
scheduledAt
string<date-time>

Schedule this email for a future time (UTC).

Examples:

"2023-01-15T01:30:15.01Z"

"2024-12-25T12:00:00Z"

​
attachments
Attachment · object[]

File attachments.

A file attachment.

​
inReplyTo
string

Message-ID of the email to reply to. Setting this automatically handles threading headers (In-Reply-To, References).

​
references
string[]

Explicit threading references. Usually not needed if in_reply_to is set.

​
replyTo
string

Reply to a previous email using its email_id (from our response). Automatically resolves to the correct Message-ID for threading headers. For advanced use, you can still use in_reply_to with raw Message-IDs.

Response

Success

Response after sending an email.

​
id
string

Unique email ID. Use this to track events and for reply_to in future emails.

​
status
enum<string>

Status is always QUEUED. Listen to webhooks/events for delivery status.

Available options:
EMAIL_STATUS_UNSPECIFIED,
EMAIL_STATUS_QUEUED,
EMAIL_STATUS_PROCESSING,
EMAIL_STATUS_SENT,
EMAIL_STATUS_FAILED
​
statusMessage
string

Human-readable description of the status.