Update a draft

gmail.updateDraft changes content, recipients, or attachments without sending the draft or moving it to another thread.

Example

automations/update-approved-draft.automation.ts

import { automation, onDashboardRun } from "automate.ax"
import { gmail } from "automate.ax/gmail"

export default automation("Update an approved Gmail draft", () => {
  onDashboardRun({ title: "Update an approved Gmail draft" })

  gmail.updateDraft({
    draftId: "r1234567890",
    subject: "Approved proposal",
    html: "<p>The proposal has been approved and is ready to send.</p>",
  })
})

Inputs

Input	Type	Required	Default	Description
`draftId`	`string`	Yes	None	Immutable Gmail draft ID to update.
`to`	`Recipient \| Recipient[]`	No	Existing value	Replacement primary recipients.
`subject`	`string`	No	Existing value	Replacement subject.
`html`	`string`	No	Existing body	Replacement HTML body.
`text`	`string`	No	Existing body or derived from replacement `html`	Replacement plain-text body.
`cc`	`Recipient \| Recipient[]`	No	Existing value	Replacement carbon-copy recipients.
`bcc`	`Recipient \| Recipient[]`	No	Existing value	Replacement blind-copy recipients.
`from`	`Recipient`	No	Existing value	Replacement sender or configured Gmail send-as alias.
`replyTo`	`Recipient \| Recipient[]`	No	Existing value	Replacement reply addresses.
`attachments`	`Attachment[]`	No	Existing attachments	Complete replacement attachment list.
`headers`	`Record<string, string>`	No	None	Additional `RFC 5322` headers on the replacement message.
`priority`	`"high" \| "normal" \| "low"`	No	Not set	Importance encoded in standard message headers.
Second argument: `{ account }`	`string \| IntegrationAccountReference<"google">`	No	Project default	Connected Google Account that owns the draft.

Recipient is an email string or { address: string; name?: string }. Attachment is a File or an object containing file with optional filename, contentId, and disposition: "attachment" | "inline". Inputs accept compatible signals. Supplying either html or text replaces both body alternatives. If you supply only html, Automate.ax derives replacement plain text. Supplying attachments replaces the complete attachment list. Use [] to remove all attachments.

Omitted recipients, sender, reply addresses, subject, body, and attachments are preserved. Custom headers and priority are applied only when supplied; existing arbitrary headers and priority are not copied forward.

The updated draft carries an authenticated automation origin. If it’s sent later, Gmail triggers don’t wake the automation that updated it, while other automations watching the mailbox still receive the event.

Output

Returns Signal<DraftIdentifier>:

Property	Type	Description
`draftId`	`string`	Immutable Gmail draft ID.
`messageId`	`string`	Immutable ID of the message stored inside the draft.
`threadId`	`string`	Gmail thread containing the updated draft.
`historyId`	`string \| undefined`	Most recent mailbox history record affecting the draft message, when supplied.
`labelIds`	`string[]`	Labels applied to the updated draft message.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

Example

Inputs

Output

​Example

​Inputs

​Output

Example

Inputs

Output