View all systems 
Gmailemail
63 available actions
What your AI agent can do in Gmail
Give your agent a bounded role in the inbox so messages can become records, follow-ups and completed office work. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 63 actions.
Common starting points
- Find an emailSearch the inbox for the customer, subject or conversation you need.
- Read a conversationBring the useful message history into the task at hand.
- Draft a replyPrepare a response using the customer and work context already available.
- Send an emailSend an approved message from the connected Gmail account.
- Reply in a threadContinue the existing conversation without losing its context.
- Update the inboxMark or organise handled messages so the next step stays clear.
Browse all 63 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 28 actions
- Fetch emailsFetches a list of email messages from a Gmail account, supporting filtering, pagination, and optional full content retrieval.
- Fetch message by message IDFetches a specific email message by its ID, provided the exists and is accessible to the authenticated .
- Fetch Message by Thread IDRetrieves messages from a Gmail thread using its , where the thread must be accessible by the specified .
- Get Gmail attachmentRetrieves a specific attachment by ID from a message in a user's Gmail mailbox, requiring valid message and attachment IDs.
- Get Auto-Forwarding SettingsTool to get the auto-forwarding setting for the specified account.
- Get contactsFetches contacts (connections) for the authenticated Google account, allowing selection of specific data fields and pagination.
- Get DraftRetrieves a single Gmail draft by its ID.
- Get Gmail filterTool to retrieve a specific Gmail filter by its ID.
- Get label detailsGets details for a specified Gmail label.
- Get Language SettingsTool to retrieve the language settings for a Gmail user.
- Get PeopleRetrieves either a specific person's details (using ) or lists 'Other Contacts' (if is true), with specifying the data to return.
- Get ProfileRetrieves Gmail profile information (email address, aggregate messagesTotal/threadsTotal, historyId) for a user.
- Get Vacation SettingsTool to retrieve vacation responder settings for a Gmail user.
- List CSE identitiesTool to list client-side encrypted identities for an authenticated user.
- List CSE key pairsTool to list client-side encryption key pairs for an authenticated user.
- List DraftsRetrieves a paginated list of email drafts from a user's Gmail account.
- List Gmail filtersTool to list all Gmail filters (rules) in the mailbox.
- List forwarding addressesTool to list all forwarding addresses for the specified Gmail account.
- List Gmail historyTool to list Gmail mailbox change history since a known startHistoryId.
- List Gmail labelsRetrieves all system and user-created labels for a Gmail account in a single unpaginated response.
- List Gmail messages (Deprecated)DEPRECATED: Use GMAIL_FETCH_EMAILS instead.
- List send-as aliasesLists the send-as aliases for a Gmail account, including the primary address and custom 'from' aliases.
- List S/MIME configsLists S/MIME configs for the specified send-as alias.
- List threadsRetrieves a list of email threads from a Gmail account, identified by (email address or 'me'), supporting filtering and pagination.
- Search PeopleSearches contacts by matching the query against names, nicknames, emails, phone numbers, and organizations, optionally including 'Other Contacts'.
- Get IMAP SettingsRetrieves the IMAP settings for a Gmail user account, including whether IMAP is enabled, auto-expunge behavior, expunge behavior, and maximum folder size.
- Get POP settingsTool to retrieve POP settings for a Gmail account.
- Get send-as aliasTool to retrieve a specific send-as alias configuration for a Gmail user.
Create & communicateCreate records or send supported messagesView 7 actions
- Create email draftCreates a Gmail email draft.
- Create Gmail filterTool to create a new Gmail filter with specified criteria and actions.
- Create labelCreates a new label with a unique name in the specified user's Gmail account.
- Create Prompt PostSend a one-shot prompt to the Sanity Content Agent.
- Import messageTool to import a message into the user's mailbox with standard email delivery scanning and classification.
- Send DraftSends an existing draft email AS-IS to recipients already defined within the draft.
- Send EmailSends an email via Gmail API using the authenticated user's Google profile display name.
Update & manageChange and manage existing recordsView 13 actions
- Modify email labelsAdds and/or removes specified Gmail labels for a message; ensure and all are valid (use 'listLabels' for custom label IDs).
- Modify thread labelsAdds or removes specified existing label IDs from a Gmail thread, affecting all its messages; ensure the thread ID is valid.
- Move to TrashMoves an existing, non-deleted email message to the trash for the specified user.
- Patch LabelPatches the specified user-created label.
- Patch send-as aliasTool to patch the specified send-as alias for a Gmail user.
- Update draftUpdates (replaces) an existing Gmail draft's content in-place by draft ID.
- Update IMAP settingsTool to update IMAP settings for a Gmail account.
- Update LabelTool to update the properties of an existing Gmail label.
- Update Language SettingsTool to update the language settings for a Gmail user.
- Update POP settingsTool to update POP settings for a Gmail account.
- Update send-as aliasTool to update a send-as alias for a Gmail user.
- Update User Attributes ValuesUpdate user attribute values for a resource.
- Update Vacation SettingsTool to update vacation responder settings for a Gmail user.
Remove & cancelRemove records or cancel supported workView 6 actions
- Delete DraftPermanently deletes a specific Gmail draft using its ID with no recovery possible; verify the correct and obtain explicit user confirmation before calling.
- Delete Gmail filterTool to permanently delete a Gmail filter by its ID.
- Delete label from account (permanent)Permanently DELETES a user-created Gmail label from the account (not from a message).
- Delete messagePermanently deletes a specific email message by its ID from a Gmail mailbox; for , use 'me' for the authenticated user or an email address to which the authenticated…
- Delete threadTool to immediately and permanently delete a specified thread and all its messages.
- Remove label (Deprecated)DEPRECATED: Use GMAIL_DELETE_LABEL instead.
Other actionsSpecialist and administrative actions.View 9 actions
- Batch delete Gmail messagesTool to permanently delete multiple Gmail messages in bulk, bypassing Trash with no recovery possible.
- Batch modify Gmail messagesModify labels on multiple Gmail messages in one efficient API call.
- Forward email messageForward an existing Gmail message to specified recipients, preserving original body and attachments.
- Insert message into mailboxTool to insert a message into the user's mailbox similar to IMAP APPEND.
- Trash threadMoves the specified thread to the trash.
- Reply to email threadSends a reply within a specific Gmail thread using the original thread's subject; do not provide a custom subject as it will start a new conversation instead of…
- Stop watch notificationsTool to stop receiving push notifications for a Gmail mailbox.
- Untrash MessageTool to remove a message from trash in Gmail.
- Untrash threadTool to remove a thread from trash in Gmail.
Connection record
A connection you can control.
- Sign-in
- OAuth sign-in
- Setup
- Sign in with your own Gmail account. Access is limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
What this unlocks
An inbox that moves the next step forward.
Search, read, draft and send within the rules you approve, with the rest of the workflow connected behind it.
Find the message that matters
Search threads and pull the relevant details into the task at hand.
Draft the useful next response
Use the customer and job context already available instead of starting from a blank page.
Keep the thread from going cold
Run approved follow-ups and keep the next action visible to the team.
FAQ
Before you connect Gmail
How does the agent connect to Gmail?
You sign in with your own Gmail account. Permissions are limited to what the agent needs, the connection is health-checked, and you can revoke access from Gmail at any time.
What can the agent actually do in Gmail?
The page above lists the 63 actions currently available through the Gmail connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Gmail included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Gmail is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Gmail to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.