Skip to main content
POST
/
v1.EmailService
/
SendEmail
Send an email to one or more recipients.
curl --request POST \
  --url https://api.simpleemailapi.dev/v1.EmailService/SendEmail \
  --header 'Authorization: Bearer <token>' \
  --header 'Connect-Protocol-Version: <connect-protocol-version>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "<string>",
  "to": [
    "<string>"
  ],
  "cc": [
    "<string>"
  ],
  "bcc": [
    "<string>"
  ],
  "subject": "<string>",
  "body": "<string>",
  "html": "<string>",
  "metadata": {},
  "scheduledAt": "2023-11-07T05:31:56Z",
  "attachments": [
    {
      "base64Content": "<string>",
      "filename": "<string>",
      "contentType": "<string>"
    }
  ],
  "inReplyTo": "<string>",
  "references": [
    "<string>"
  ],
  "async": true
}
'
{
  "id": "<string>",
  "status": "EMAIL_STATUS_UNSPECIFIED",
  "messageId": "<string>",
  "statusMessage": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key authentication. Sign up on the dashboard, create a workspace, and grab your API key (starts with em_). Include it in the Authorization header as: Bearer em_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., "[email protected]").

​
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.

​
async
boolean

Set to true to return immediately and send the email in the background. Recommended for bulk sending or when attachments are large.

Response

Success

Response after sending an email.

​
id
string

Unique system ID for this email. Use this to track events.

​
status
enum<string>

Current status.

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

Upstream Message-ID (if available immediately).

​
statusMessage
string

Human-readable description of the status.