Search documentation

Search guides, connectors and tools

Google Gmail

Gmail account connector to manage emails and drafts.

12 tools1 trigger

Connecting

An admin of your organization connects an account in Integrations → Add Integration by picking Google Gmail and signing in with the provider. See integrations.

Tools

Ask an agent for what you need in plain language — it picks the right tool itself. You can also limit which of these an agent may use, and require your approval before any of them runs.

Create Draft

€0.01 per call

Create a draft email.

What you can specify: To, Subject, Body

Change Labels

€0.01 per call

Add or remove labels on a message.

What you can specify: Message, Add labels, Remove labels

Add Attachment to Draft

€0.01 per call

Add a file attachment from agent storage to an existing Gmail draft.

What you can specify: Draft ID, Path, Attached as

Search Emails

€0.01 per call

Search Gmail messages using Gmail search syntax and return matching message summaries.

What you can specify: Query, Labels, Max results

Get Email

€0.01 per call

Fetch the full content of a Gmail message including headers, body, and attachment list.

What you can specify: Message ID

Get Thread

€0.01 per call

Fetch all messages in a Gmail conversation thread with their headers and bodies.

What you can specify: Thread ID

List Labels

€0.01 per call

List all Gmail labels with their IDs and names (needed to add or remove labels).

Save Attachment

€0.01 per call

Download an attachment from a Gmail message and store it in agent file storage.

What you can specify: Message ID, Attachment ID, Filename, Directory

Send Email

€0.01 per call

Send an email immediately, optionally as a reply within an existing thread.

What you can specify: To, Subject, Body, Cc, Bcc, Thread ID, In reply to

Send Draft

€0.01 per call

Send an existing Gmail draft.

What you can specify: Draft ID

Trash Message

€0.01 per call

Move a Gmail message to the Trash. The message is recoverable, not permanently deleted.

What you can specify: Message ID

Create Label

€0.01 per call

Create a new Gmail label.

What you can specify: Name

Triggers

Triggers start an agent automatically when something happens in the connected account. See triggers and schedules.

Receive Email

Triggers when a new email is received.

Filters

  • Sender — Only emails whose sender address matches. The pattern must match the whole address, ignoring case: * stands for any characters and ? for one, for example *@acme.com.
  • Subject — Only emails whose subject matches. The pattern must match the whole subject, ignoring case, so use *invoice* to find a word anywhere in it.
  • Body contains — Only emails whose text contains this, ignoring case.
  • Has attachment — Only emails with at least one attachment.

Permissions

When you connect an account, the provider asks you to allow the following. A tool or trigger is only available if you allowed what it needs, so allowing less simply means fewer tools.

  • Manage drafts and send emails
  • Read, compose, and send emails