Send Email

SendEmail sends a new email POST /api/v1/compose/send

Authentication & compatibility

Use a scoped bearer API key with email:send. The key is bound to its user and organization.

Primary SES compose workflow. Reply/forward contexts use public SES mailbox UUIDs; draft and attachment operations use owned records. In legacy non-SES configurations, sending can fall back to JMAP.

Contract 2026-10-04. Your running instance's /api/v1/openapi.json is authoritative for its deployed release.

Request

Set MAILAT_BASE_URL to your instance origin (without /api/v1) and MAILAT_TOKEN to an appropriate credential. Replace path placeholders and example data before running. These examples do not execute in this page.

curl --request POST "$MAILAT_BASE_URL/api/v1/compose/send" \
  --header "Authorization: Bearer $MAILAT_TOKEN" \
  --header "Idempotency-Key: replace-with-a-stable-job-key" \
  --header 'Content-Type: application/json' \
  --data '{
  "identityId": 1,
  "inReplyTo": "<[email protected]>",
  "references": [
    "<[email protected]>"
  ],
  "subject": "Re: Hello",
  "textBody": "Thank you",
  "to": [
    {
      "email": "[email protected]"
    }
  ]
}'

Responses

HTTP statuses and body shapes below come from the pinned contract. Not every shared error applies to every request. Retain the original idempotency key when retrying a send.