Search drafts - Automate.ax

gmail.searchDrafts returns draft and message IDs from the connected account using Gmail search-box syntax.

Example

automations/find-review-drafts.automation.ts

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

export default automation("Find drafts awaiting review", () => {
  onDashboardRun({ title: "Find drafts awaiting review" })

  gmail.searchDrafts({
    query: "to:customer@example.com subject:proposal",
    limit: 25,
  })
})

Inputs

Input	Type	Required	Default	Description
`query`	`string`	No	All drafts	Standard Gmail search-box query.
`limit`	`number`	No	`100`	Maximum total results. Must be an integer from 1 through 10,000.
`includeSpamTrash`	`boolean`	No	`false`	Allow drafts in Spam and Trash to match.
Second argument: `{ account }`	`string \| IntegrationAccountReference<"google">`	No	Project default	Connected Google Account to search.

Inputs accept compatible signals. Automate.ax fetches additional Gmail pages internally until it reaches limit or Gmail has no more results.

Output

Returns Signal<DraftIdentifier[]>. Each item contains:

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

Use draftId, not messageId, with gmail.getDraft, gmail.updateDraft, gmail.sendDraft, and gmail.deleteDraft.