Draft Operations

Use the Draft operations to create, delete, or get a draft or list drafts in Gmail. Refer to the Gmail node for more information on the Gmail node itself.

Create a draft

Use this operation to create a new draft.

Enter these parameters:

• Select the Credential to connect with or create a new one.
• Resource: Select Draft.
• Operation: Select Create.
• Subject: Enter the subject line.
• Select the Email Type. Choose from Text or HTML.
• Message: Enter the email message body.

Create draft options

Use these options to further refine the node's behavior:

• Attachments: Select Add Attachment to add an attachment. Enter the Attachment Field Name (in Input) to identify which field from the input node contains the attachment.
• For multiple properties, enter a comma-separated list.
• BCC: Enter one or more email addresses for blind copy recipients. Separate multiple email addresses with a comma, for example jay@gatsby.com, jon@smith.com.
• CC: Enter one or more email addresses for carbon copy recipients. Separate multiple email addresses with a comma, for example jay@gatsby.com, jon@smith.com.
• From Alias Name or ID: Select an alias to send the draft from. This field populates based on the credential you selected in the parameters.
• Send Replies To: Enter an email address to set as the reply to address.
• Thread ID: If you want this draft attached to a thread, enter the ID for that thread.
• To Email: Enter one or more email addresses for recipients. Separate multiple email addresses with a comma, for example jay@gatsby.com, jon@smith.com.

Refer to the Gmail API Method: users.drafts.create documentation for more information.

Delete a draft

Use this operation to delete a draft.

Enter these parameters:

• Select the Credential to connect with or create a new one.
• Resource: Select Draft.
• Operation: Select Delete.
• Draft ID: Enter the ID of the draft you wish to delete.

Refer to the Gmail API Method: users.drafts.delete documentation for more information.

Get a draft

Use this operation to get a single draft.

Enter these parameters:

• Select the Credential to connect with or create a new one.
• Resource: Select Draft.
• Operation: Select Get.
• Draft ID: Enter the ID of the draft you wish to get information about.

Get draft options

Use these options to further refine the node's behavior:

• Attachment Prefix: Enter a prefix for the name of the binary property the node should write any attachments to. n8n adds an index starting with 0 to the prefix. For example, if you enter \`attachment\_' as the prefix, the first attachment saves to 'attachment\_0'.
• Download Attachments: Select whether the node should download the draft's attachments (turned on) or not (turned off).

Refer to the Gmail API Method: users.drafts.get documentation for more information.

Get Many drafts

Use this operation to get two or more drafts.

Enter these parameters:

• Select the Credential to connect with or create a new one.
• Resource: Select Draft.
• Operation: Select Get Many.
• Return All: Choose whether the node returns all drafts (turned on) or only up to a set limit (turned off).
• Limit: Enter the maximum number of drafts to return. Only used if you've turned off Return All.

Get Many drafts options

Use these options to further refine the node's behavior:

• Attachment Prefix: Enter a prefix for the name of the binary property the node should write any attachments to. n8n adds an index starting with 0 to the prefix. For example, if you enter \`attachment\_' as the prefix, the first attachment saves to 'attachment\_0'.
• Download Attachments: Select whether the node should download the draft's attachments (turned on) or not (turned off).
• Include Spam and Trash: Select whether the node should get drafts in the Spam and Trash folders (turned on) or not (turned off).

Refer to the Gmail API Method: users.drafts.list documentation for more information.

Common issues

For common errors or issues and suggested resolution steps, refer to Common Issues.