Connect Gmail with Hookshot™ and your stack

Gmail is Google’s email service, featuring spam protection, search functions, and seamless integration with other G Suite apps for productivity

Browse integrations Visit website

Tools and triggers

What Agents can do in Gmail

Available tools and events after Gmail is connected.

  • Batch Delete Gmail Messages

    This action allows you to delete multiple Gmail messages at once by specifying their IDs. It's useful for managing email clutter and enforcing retention policies.

  • Batch Modify Gmail Messages

    This action allows users to modify labels on multiple Gmail messages simultaneously. It supports adding or removing labels for up to 1,000 messages in a single request.

  • Create Email Draft

    This action creates a draft email in Gmail. It allows specifying recipients, subject, body content, and attachments, enabling users to prepare emails for sending at a later time.

  • Create Gmail Filter

    Tool to create a new Gmail filter with specified criteria and actions. Use when the user wants to automatically organize incoming messages based on sender, subject, size, or other criteria. Note: you can only create a…

  • Create Label

    This action creates a new label in the user's Gmail account with the specified properties. It ensures that the label name is unique and validates the color selections for the label.

  • Create Prompt Post

    Send a one-shot prompt to the Sanity Content Agent. Stateless one-shot prompt endpoint. No thread management or message persistence. Ideal for simple, single-turn interactions. Use when you need to send a single prompt…

  • Delete Draft

    This action deletes a specified Gmail draft by its ID. It requires the user's permissions to perform this operation on the specified draft.

  • Delete Gmail Filter

    Tool to permanently delete a Gmail filter by its ID. Use when you need to remove an existing email filtering rule.

  • Delete Label From Account (permanent)

    This action permanently DELETES a custom label from your Gmail account. The label will be removed from all messages that had it. System labels (INBOX, SENT, DRAFT, UNREAD, STARRED, etc.) cannot be deleted. WARNING: If…

  • Delete Message

    This action deletes a specified email message from a Gmail mailbox. You can use it to remove messages either for the authenticated user or another user with delegated access.

  • Delete Thread

    Tool to immediately and permanently delete a specified thread and all its messages. This operation cannot be undone. Use threads.trash instead for reversible deletion.

  • Fetch Emails

    This action retrieves a list of email messages from a specified Gmail account. It allows for filtering the messages based on various parameters such as label IDs and search queries, as well as controlling the level of…

  • Fetch Message by Message ID

    This action retrieves an email message from Gmail using its unique message ID. It allows users to access information about the email content based on the provided user ID.

  • Fetch Message by Thread ID

    This action retrieves messages from a specific Gmail thread. It requires the thread's ID and the user's ID to access the messages within that thread.

  • Forward Email Message

    This action allows users to forward an existing Gmail message to one or more specified recipients. It retains the original message body and attachments while allowing for optional additional text to be included in the…

  • Get Auto-Forwarding Settings

    Tool to get the auto-forwarding setting for the specified account. Use when you need to retrieve the current auto-forwarding configuration including enabled status, forwarding email address, and message disposition.

  • Get Contacts

    This action retrieves the list of contacts associated with the authenticated user's Google account. It allows for filtering the fields that are returned and supports pagination for large sets of contacts.

  • Get Draft

    Retrieves a single Gmail draft by its ID. Use this to fetch and inspect draft content before sending via GMAIL_SEND_DRAFT. The format parameter controls the level of detail returned.

  • Get Gmail Attachment

    This action fetches a specific attachment from a user's Gmail messages using the provided message and attachment IDs. It ensures that the returned attachment is valid and is appropriately decoded for the user.

  • Get Gmail Filter

    Tool to retrieve a specific Gmail filter by its ID. Use when you need to inspect the criteria and actions of an existing filter.

  • Get IMAP Settings

    This action retrieves the IMAP settings configured for a Gmail user account. It provides information about IMAP configuration, such as whether IMAP is enabled and how messages are handled when deleted.

  • Get Label Details

    Gets details for a specified Gmail label. Use this to retrieve label information including name, type, visibility settings, message/thread counts, and color.

  • Get Language Settings

    Tool to retrieve the language settings for a Gmail user. Use when you need to determine the display language preference for the authenticated user or a specific Gmail account.

  • Get People

    This action fetches details about a specific person identified by the resource name or retrieves a list of 'Other Contacts' if requested. You can specify which person-related fields you want to return.

Setup

Connect Gmail in Hookshot™

Pick a scope, then confirm what can start a Protege and what it can do.

Trigger Access

What can start a Protege from this app.

Tool Access

What a Protege can do after it starts.

Connection scope

Prefer team for production.

Team

Shared credential for production and unattended runs.

Personal

Tied to one user—only when the workflow needs their account.

Chat

Team-scoped for supported chat surfaces.

Full setup guide

Build with us

See Hookshot™ in your stack.

Request early access or book a live walkthrough with the team.

Request Demo
Hookshot™ setup screen — AI agent workflow configuration with model selection, trigger status, and governance controls.