Gmail Setup Guide
Enables your agent to send, read, draft, and delete emails via your Gmail account.
Overview
Gmail uses OAuth — the Carapace dashboard handles the entire authorization flow. You don't need to create any API keys or tokens manually.
Prerequisites
- A Google account with Gmail
Step 1: Connect via Dashboard
- Go to Dashboard > Connections
- Find Gmail and click Connect
- A Google OAuth popup will open
- Sign in with your Google account
- Review the requested permissions:
- Read your email (gmail.readonly)
- Send email on your behalf (gmail.send)
- Click Allow
- The popup closes and the connection is established
That's it. No tokens to copy or paste.
Credential Fields Reference
No manual credential entry required. OAuth tokens are managed automatically by the dashboard.
Gotchas
"Unverified app" warning: In development or staging environments, Google may show a warning that the app is unverified. Click Advanced > Go to [app name] (unsafe) to proceed. This is expected for non-production OAuth apps.
Revoking access breaks the connection: If you revoke Carapace's access in Google Account > Security > Third-party apps, the connection will stop working. Reconnect via the dashboard if this happens.
Refresh tokens: The OAuth flow requests offline access, so the token auto-refreshes. No manual intervention is needed unless access is revoked.