Reply to a thread

replyThread finds the latest received message in a Gmail thread and replies to it. Use it when your automation stores a conversation’s threadId rather than the exact message that should receive the next response.

Example

automations/continue-conversation.automation.ts

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

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

  replyThread({
    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 latest received message even after the conversation has been archived.

Inputs

Input	Type	Required	Default	Description
`threadId`	`string`	Yes	—	Immutable Gmail ID of the thread receiving the reply.
`replyAll`	`boolean`	No	`false`	Include original To and Cc recipients, excluding 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 MIME 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.
`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". Every input, including account, also accepts a compatible Signal.

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.

Output

Returns a Signal<MessageMetadata> with:

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

Get started

Concepts

Reference

Example

Inputs

Output

​Example

​Inputs

​Output

Example

Inputs

Output