Gmail
The Gmail integration lets Helios agents search the Gmail API and call any endpoint to send email, read and organize messages, and manage labels and settings.
What your agents can do
Agents don't pick from a preset list of actions. They semantically search the entire Gmail API and call whatever endpoint a task needs, using your connected credentials. There is no fixed set of email operations to choose from.
- Draft, send, reply to, and forward email
- Read and search messages and threads
- Organize your inbox with labels
- Modify messages (mark read, archive, move between labels)
- Manage signatures, forwarding, filters, and other basic settings
Authentication
| Method | Type | Description |
|---|---|---|
| Helios Google app (recommended) | OAuth 2.0 | Per-user consent with pre-configured Gmail scopes |
| BYO Google app | OAuth 2.0 | Bring your own Google OAuth app and credentials |
Helios Google app (recommended)
Connect in one click. Helios runs the Google OAuth redirect flow and asks each user for consent (access_type=offline, prompt=consent) so agents can act on your behalf, including when you're offline.
The Helios Google app requests scopes to:
- Compose, send, and insert email (
gmail.compose,gmail.send,gmail.insert) - Read and modify messages and threads (
gmail.readonly,gmail.modify) - Manage labels (
gmail.labels) - Read and update basic settings and sharing (
gmail.settings.basic,gmail.settings.sharing)
BYO Google app
Bring your own Google OAuth application when you need custom scopes or branding.
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable the Gmail API
- Configure the OAuth consent screen
- Create OAuth 2.0 credentials (client ID and client secret)
- Add the Helios redirect URI to your OAuth client
- In Helios, supply your client ID, client secret, an access token, a refresh token, and the Google account email
Learn more in the Gmail API documentation.
Triggers
Gmail does not currently emit event triggers into Helios. Use it from Chat, or from a Workflow driven by a schedule, webhook, or manual run.
Notes
Helios requests granular Gmail scopes for composing, reading, modifying, and labeling mail, but deliberately does not request the full-mailbox mail.google.com scope.
Last updated on
WarpBuild
The WarpBuild integration lets Helios agents search and call the entire WarpBuild API to manage runners, builders, cloud connections, and monitor build infrastructure.
Google Docs
The Google Docs integration lets Helios agents search the Google Docs API and call any endpoint to create documents, edit content, and manage formatting.