Create Draft
Create a draft in an inbox, either to start a new thread or reply to an existing thread.
POST
A draft lets you prepare a message before sending it.
Path Parameters
Body Parameters
string | string[] | null
Recipients. For multiple addresses, send an array of strings. Each value can
include a friendly name, for example
Ada Lovelace <ada@example.org>.string | string[] | null
CC recipients.
string | string[] | null
BCC recipients.
string | null
The subject. Max 2000 characters.
string | null
The HTML body.
string | null
The plain-text body.
array
Files to store on the draft.
Headers
string
Add an idempotency key to prevent duplicated drafts.
- Should be unique per API request
- Idempotency keys expire after 24 hours
- Have a maximum length of 256 characters
- A retry with the same key returns the first successful response, with the
idempotent-replayed: trueheader - A failed request is not stored, so you can retry it with the same key
- Reusing the key with a different body, or while the first request is still
running, returns a
409
Response Fields
string
Always
inbox_draft.string
The ID of the draft.