> ## Documentation Index
> Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gmail

> Set up and use the Gmail integration with Hyper AI

Auth type: OAuth

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect Gmail

1. Go to Settings → Apps in Hyper
2. Select Gmail → Connect New
3. Complete OAuth and grant email scopes

## Common capabilities

* Read, label, and search emails (with approval controls)
* Draft and send messages
* Extract action items for flows

## Use in Chat

Enable Gmail in the tool selector. Ask your agent to find emails, draft replies, or summarize threads.

## Use in Agents

Add Gmail to an agent’s toolkits and select the connection. Mark sensitive actions (send email) as “requires approval.”

## Use in Flows

Automate follow‑ups, SLA checks, and routing using Gmail action nodes with filters and variables.

## Troubleshooting

* Missing messages: verify label and search filters
* Send blocked: check approval settings or re‑authorize scopes

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action              | Description                                                                  |
| ------------------- | ---------------------------------------------------------------------------- |
| Add Labels          | Add labels to an email message                                               |
| Archive Message     | Archive an email message                                                     |
| Create Draft        | Create a draft email with optional CC, BCC, and attachments                  |
| Create Label        | Create a new Gmail label                                                     |
| Delete Draft        | Delete a draft email                                                         |
| Delete Message      | Permanently delete a message                                                 |
| Get Attachments     | Download all attachments from an email message and save them to file storage |
| Get Draft           | Get details of a specific draft email                                        |
| Get Message         | Get detailed information about a specific email message                      |
| Get Message Body    | Get the body content of an email message                                     |
| Get Signature       | Get the email signature configured for the user's Gmail account              |
| List Drafts         | List all draft emails in your Gmail account                                  |
| List Labels         | List all available Gmail labels                                              |
| List Messages       | List email messages from Gmail with various filter options                   |
| Modify Labels       | Add or remove labels from a message                                          |
| Move Email To Label | Move an email from INBOX to a specified label                                |
| Remove Labels       | Remove labels from an email message                                          |
| Reply To Message    | Reply to an existing email, properly threading the reply in the conversation |
| Search              | Search Gmail for messages matching specific criteria                         |
| Send Draft          | Send an existing draft email                                                 |
| Send Message        | Send an email message with optional CC, BCC, and attachments                 |
| Trash Message       | Move a message to the trash                                                  |
| Untrash Message     | Restore a message from trash                                                 |
| Update Draft        | Update an existing draft email                                               |