Skip to main content
POST
Send an email

Authorizations

Authorization
string
header
required

Workspace API key or delegated OAuth access token with /v1 resource audience. Administrative routes require the Better Auth browser session instead.

Headers

Idempotency-Key
string
required

Reuse for the same logical action and identical body; changed input returns 409.

Required string length: 1 - 200

Path Parameters

id
string
required

Body

application/json
to
string<email>[]
required
Required array length: 1 - 10 elements
Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
subject
string
required
Maximum string length: 998
text
string
required
Required string length: 1 - 100000
attachments
object[]
Maximum array length: 10

Response

Successful JSON response

id
string
required
Minimum string length: 1
status
enum<string>
required

Operation state. Completed sends mean provider acceptance, not recipient delivery. Poll pending or unknown operations; do not resend with a new key.

Available options:
pending,
unknown,
completed,
failed
messageId
string | null
required
Minimum string length: 1
statusUrl
string
required