Auth type: OAuthDocumentation Index
Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
For general setup steps, permissions, and troubleshooting, start with: App Integrations.
Connect Gmail
- Go to Settings → Apps in Hyper
- Select Gmail → Connect New
- 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 |
| 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 |