SendSend a single email

Send a single email

Every send is routed through one of your dedicated IPs. If ip_id is omitted, the account's default IP is used. If you have no active IPs, the request fails with 400 — contact support to have one assigned to your account.

curl -X POST "https://api.supasend.io/v1/send" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "mailbox_id": "507f1f77bcf86cd799439011",
  "ip_id": "65f1c8a2b3d4e5f607890abc",
  "to": "recipient@example.com",
  "subject": "Hello from SupaSend",
  "body_html": "<h1>Hello!</h1><p>This is a test email.</p>",
  "body_text": "Hello! This is a test email.",
  "reply_to": "user@example.com",
  "headers": {}
}'
{
  "id": "507f1f77bcf86cd799439011",
  "status": "queued"
}
POST
/v1/send
POST
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key in the format sk_live_<64 hex characters>

API key in the format sk_live_<64 hex characters>
Content-Typestring
Required

The media type of the request body

Options: application/json
mailbox_idstring
Required

MongoDB ObjectID of the mailbox to send from

ip_idstring

Optional dedicated IP to send this email from. When omitted, the email is sent via the mailbox's default route.

tostring
Required
Format: email
body_htmlstring

HTML email body

body_textstring

Plain text email body

reply_tostring
Format: email
headersobject

Custom SMTP headers

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. API key in the format sk_live_\<64 hex characters\>

Body

application/json
mailbox_idstring
Required

MongoDB ObjectID of the mailbox to send from

Example:
507f1f77bcf86cd799439011
ip_idstring

Optional dedicated IP to send this email from. When omitted, the email is sent via the mailbox's default route.

Example:
65f1c8a2b3d4e5f607890abc
tostring
Required
Example:
recipient@example.com
subjectstring
Required
Example:
Hello from SupaSend
body_htmlstring

HTML email body

Example:
<h1>Hello!</h1><p>This is a test email.</p>
body_textstring

Plain text email body

Example:
Hello! This is a test email.
headersobject

Custom SMTP headers

Responses