Update a Draft

Updates the specified Draft by setting the values of the parameters passed. Any parameters not provided will be left unchanged. Outlook native reply drafts, including drafts created in Outlook, keep their conversation. Omit reply_to_message_id: an existing Outlook draft cannot be reparented. Attachments replace the existing list when provided.

Multipart supported, refer to Sending Files.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
string
required
^acc_(.*)$

ID of the Account (acc_xxx) to call the method on behalf of.

Body Params
string

The HTML content of the draft. Required for tracking.

string

The plain text content of the draft.

string

Subject of the draft.

from
object
to
array of objects

List of attendees to set in to header.

to
cc
array of objects

List of attendees to set in cc header.

cc
bcc
array of objects

List of attendees to set in bcc header.

bcc
reply_to
array of objects

List of attendees to set in the standard Reply-To header. Recipients answering the email will reply to these addresses instead of from. To reply inside an existing conversation, use reply_to_message_id instead.

reply_to
string
length ≥ 1

The ID of the email message that you're replying to. For Gmail, use the provider message ID. For IMAP, use the RFC822 Message-ID header. Outlook cannot change the parent of an existing draft: omit this field when updating a native reply draft to preserve its conversation. Set it when creating the draft instead.

attachments
array of objects

The list of file attachments to the draft. Any attachment already existing will be removed and replaced by the new ones. For Outlook, each attachment must be smaller than 3 MB.

attachments
tracking_options
object

Configuration of tracking for this email.

specifics
object

Object containing provider-specific draft update data.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json