Sign in

v19

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-017489931.2 KB

Send an email

Sends an email via the connected email account that owns the from address. Currently supports new sends only; replies and forwards are not yet supported.

Supports idempotency via the Idempotency-Key header.

Required scope: emails:create

Rate limit category: Write

post/v1/emails/send

Headers

Lightfield-Version'2026-03-01' required

Required API version header. Requests may error without it.

Request body

fromstring required

Bare email address (no display name). Must match a connected email account owned by the API key user. Compared case-insensitively. Used as the From header when sending.

tostring[] required

Recipient email addresses (bare, no display names). At least 1, at most 500.

ccstring[]

Cc recipients (same shape as to).

bccstring[]

Bcc recipients (same shape as to).

subjectstring required

Email subject. Cannot be empty.

attachmentsstring[]

Optional list of file IDs (uploaded via the Files API) to attach to the email. Maximum 5 attachments per email, each ≤ 3MB.

Example request

{
  "from": "sales@acme.com",
  "to": [
    "lead@example.com"
  ],
  "cc": [
    "lead@example.com"
  ],
  "bcc": [
    "lead@example.com"
  ],
  "subject": "Following up on our chat",
  "messageBody": {
    "contentType": "HTML",
    "content": "<p>Hi there,</p><p>Following up on our chat earlier this week.</p>"
  },
  "attachments": [
    "file_01abc2def3ghi4jkl5mno6pqr"
  ]
}

Response

OK

sentAtstring required

ISO 8601 timestamp of when the send completed.