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>",
  "statusMessage": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.simpleemailapi.dev/llms.txt

Use this file to discover all available pages before exploring further.

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.