Create a draft email

Creates a draft in the connected email account that owns the from address. Mirrors native email-client behavior: only from is required — to, cc, bcc, subject, messageBody, and attachments are all optional. At least one of those optional fields must be populated; sending only from returns a 400.

Supports idempotency via the Idempotency-Key header.

Required scope: emails:create

Rate limit category: Write

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