Messages

Send email

post/v1/inboxes/{inbox_id}/messages

Request

  • Base URL: https://api.deadsimple.email
  • URL: https://api.deadsimple.email/v1/inboxes/{inbox_id}/messages
  • Auth: HTTP bearer

Path parameters

inbox_idstring required

Headers

X-Workspace-Idstring uuid

Target a specific workspace. Required for account-wide API keys that want workspace-scoped results.

Request body

subjectstring required
text_bodystring
html_bodystring
ccstring[]
bccstring[]
send_atstring date-time

Schedule send for a future time (ISO 8601)

labelsstring[]

Labels to attach to the message on creation

reply_tostring
headersobject
trackingboolean

Enable open/click tracking (HTML emails only)

template_idstring uuid

Render a template instead of using body fields

variablesobject

Template variable substitutions

in_reply_tostring

Parent message to thread onto. Accepts either a message_id from this inbox or a raw Message-ID header.

referencesstring[]

Message-ID headers for threading

Example request

{
  "calendar_invite": {
    "title": "Roof inspection - 124 Lakeshore Dr",
    "start": "2026-09-15T15:00:00",
    "timezone": "America/New_York",
    "duration_minutes": 45,
    "location": "124 Lakeshore Dr"
  }
}

Response

Email sent

Changes

No recorded changes to this operation across all 1 revision of this API.