Gmail:Create Draft
Controlled node
Overview
Prepare a Gmail message for review without sending it.
Create a draft in the connected Gmail account for someone to review and send. Provide messageId to create a reply draft instead of a new message. This node does not send the draft.
Inputs
| Input | Type | Description |
|---|---|---|
| run | Event | Triggers this operation. |
| to | Text or array | Primary recipient: one email address, or an array of addresses supplied through a data connection. Set this explicitly for replies; the original sender is not filled in automatically. Optional for an unfinished draft. |
| cc | Text or array | Optional copy recipients: one email address or an array of addresses. |
| bcc | Text or array | Optional blind-copy recipients: one email address or an array of addresses. |
| subject | Text | Draft subject. For a reply draft, leave unset to retain the original reply subject. |
| messageId | Text | Optional: creates a reply draft. Use the original message’s id, not threadId. |
| threadId | Text | Optional Gmail thread ID. When replying by messageId, the original thread is used if this is unset. |
| bodyText | Text | Plain-text message body. Can accompany an HTML alternative. |
| bodyHtml | Text | Optional HTML alternative to the plain-text body. |
| attachments | File or array | Optional library file object, or an array of file objects. Each file must have id and name; use actual library files or file outputs from earlier nodes. |
Properties
| Setting | Type | Description |
|---|---|---|
| connections | Connection | Select an authenticated Gmail connection from this project in the properties panel. |
Outputs
| Output | Type | Description |
|---|---|---|
| status | Text | draft created on success; otherwise an error message. |
| draftId | Text | Identifier of the created draft. Use only after confirming status is draft created. |
| done | Event | Fires when the node returns, including when it returns an error result. Check the data output before continuing. |
Recipients and attachments
For multiple recipients, connect an array such as ["alex@example.com", "sam@example.com"]; do not enter a comma-separated list into a single address field. Use bare email addresses, without display names. Empty text fields are treated as unset.
Attachments must reference files in this project, not external URLs or local file paths. Keep attachments small enough for the mail provider to accept.
done also fires when an error message is returned. Compare status with draft created before treating the operation as successful.
Example
Set to to alex@example.com, subject to Draft report and bodyText to your draft content. Select the connection and trigger run from Start. On done, inspect status and draftId, then review the draft in Gmail.
For a draft reply, also supply the original message’s id as messageId.