Reply to a message

gmail.replyToMessage replies to a message in its conversation, using that message’s recipient and conversation headers.

Example

automations/acknowledge-email.automation.ts

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

export default automation("Acknowledge new email", () => {
  const email = gmail.onNewEmail()

  gmail.replyToMessage({
    messageId: email.messageId,
    text: "Thanks for reaching out. We received your message.",
  })
})

Gmail sends the reply to the source message’s Reply-To address when present, otherwise to its From address. The action preserves the source subject and standard conversation headers automatically.

Inputs

Input	Type	Required	Default	Description
`messageId`	`string`	Yes	None	Immutable Gmail ID of the message receiving the reply.
`replyAll`	`boolean`	No	`false`	Include original To and Cc recipients. Omit the connected account and primary reply address.
`html`	`string`	No	None	HTML reply body.
`text`	`string`	No	Derived from `html`	Plain-text reply body.
`to`	`Recipient \| Recipient[]`	No	None	Additional primary recipients appended to the derived recipient.
`cc`	`Recipient \| Recipient[]`	No	None	Additional carbon-copy recipients.
`bcc`	`Recipient \| Recipient[]`	No	None	Additional blind-copy recipients.
`from`	`Recipient`	No	Gmail account address	Sender address or configured Gmail send-as alias.
`replyTo`	`Recipient \| Recipient[]`	No	None	Addresses that should receive replies to the outgoing reply.
`attachments`	`Attachment[]`	No	`[]`	Files and inline message parts attached to the reply.
`headers`	`Record<string, string>`	No	None	Additional `RFC 5322` headers.
`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 used to send the reply.

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.

replyAll: true may notify every original To and Cc recipient. Leave it off for a private reply.

The action fails when the source message lacks a Gmail thread ID, subject, standard Message-ID, or both Reply-To and From headers. The reply carries an authenticated automation origin. Gmail triggers don’t wake the automation that sent it, while other automations watching the mailbox still receive the event.

Output

Returns Signal<MessageMetadata>:

Property	Type	Description
`messageId`	`string`	Immutable Gmail ID of the sent reply.
`threadId`	`string`	Gmail thread containing the source message and reply.
`historyId`	`string \| undefined`	Most recent mailbox history record affecting the reply, when supplied.
`labelIds`	`string[]`	Labels applied to the sent reply.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

Example

Inputs

Output

​Example

​Inputs

​Output

Example

Inputs

Output