Gmail

Connect Gmail to read emails, manage labels, and send messages through Cendriix agents.

Overview

How to connect

1. Navigate to Settings → Integrations → Connectors
2. Click Connect on the Gmail integration
3. Sign in with your Google account and authorize access
4. Once authorized, email data becomes available to Cendriix agents

Admin setup (self-hosted)

If you’re running Cendriix on your own infrastructure, an admin needs to:

1. Create OAuth credentials in Google Cloud Console 
2. Enable the Gmail API in your project
3. Set the redirect URL to: https://api.<your-domain>/v1/connectors/gmail/oauth/callback
4. Store the credentials in AWS Secrets Manager at cendriix/prod/connectors/gmail:

   { "client_id": "...", "client_secret": "..." }

Capabilities

Once connected, Cendriix agents can:

• Read email messages and threads
• Manage labels and organize inbox
• Send emails on your behalf when authorized

Security notes

• Google OAuth tokens support refresh with offline access
• Revocation available via Google’s OAuth revocation endpoint
• Disconnect at any time from Settings → Integrations → Connectors

Further reading

• Gmail API Overview 
• Google OAuth 2.0