Skip to main content
PATCH
Updates the content of an unsent draft. A draft that was already sent returns a 409.

Path Parameters

Body Parameters

Send at least one field. Omitted fields keep their current value. A request with html or text replaces both, and the one you leave out is saved as null. After the update, the draft must still have at least one non-empty field, and to, cc, and bcc combined cannot exceed 50 recipients.
string | string[] | null
Recipients. Send null or [] to clear them.
string | string[] | null
CC recipients. Send null or [] to clear them.
string | string[] | null
BCC recipients. Send null or [] to clear them.
string | null
The subject. 1 to 2000 characters, with no line breaks. Send null to clear it.
string | null
The HTML body. Send null to clear it.
string | null
The plain-text body. Send null to clear it.
array | null
Files to store on the draft, up to 25 MB in total, downloaded files included. All path downloads must finish within 20 seconds together. Sending the field replaces every attachment on the draft. Send null or [] to remove them all. Drafts do not accept content_id.

Response Fields

string
Always inbox_draft.
string
The ID of the draft.