Reply to a thread

gmail.replyToThread replies to the most recently received message when you have a threadId instead of the exact message ID.

Example

automations/continue-conversation.automation.ts

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

export default automation("Continue a Gmail conversation", () => {
  const email = gmail.onNewEmail()

  gmail.replyToThread({
    threadId: email.threadId,
    text: "Thanks for the update. We will follow up shortly.",
  })
})

The action ignores messages carrying Gmail’s SENT label. This lets it target the most recently received message even after Gmail archives the conversation.

Inputs

Input	Type	Required	Default	Description
`threadId`	`string`	Yes	None	Immutable Gmail ID of the thread 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 To and Cc recipient on the selected message.

The action fails if the thread contains no message without the SENT label. The selected message must also contain the headers required for a reply. 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 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