Gmail Integration
Connect your Gmail account to trigger agents from incoming emails, send automated responses, and sync with Google Workspace.
Quick Setup (2 minutes)
Connect with one click using Google OAuth. No API keys or manual configuration required.
What You Can Do
Trigger from Emails
Start agent workflows when emails arrive matching your criteria (sender, subject, labels)
Send Responses
Auto-reply to emails, send follow-ups, or create drafts for review
Organize Inbox
Apply labels, move to folders, mark as read/starred based on AI analysis
Extract Data
Pull contact info, order details, or key data from email content
Setup Instructions
Go to Integrations
Navigate to Dashboard β Integrations and find Gmail in the list.
Authorize with Google
Click "Connect" and sign in with your Google account. Grant the requested permissions.
- β Read email messages and settings
- β Send email on your behalf
- β Manage labels and organize emails
Configure Triggers
Choose which emails should trigger your agents.
Done!
Your Gmail is now connected. You can use it in any agent that supports email triggers or actions.
Example Workflows
π― Lead Capture from Email
π§ Support Ticket Triage
π Meeting Scheduling
Data Available from Gmail
{
"message_id": "18d1a2b3c4d5e6f7",
"thread_id": "18d1a2b3c4d5e6f7",
"from": {
"email": "john@company.com",
"name": "John Smith"
},
"to": ["you@yourcompany.com"],
"cc": [],
"subject": "Partnership Inquiry",
"body_text": "Hi, I'm interested in...",
"body_html": "<p>Hi, I'm interested in...</p>",
"date": "2026-01-15T10:30:00Z",
"labels": ["INBOX", "IMPORTANT"],
"attachments": [
{
"filename": "proposal.pdf",
"mime_type": "application/pdf",
"size_bytes": 125000
}
],
"is_unread": true,
"snippet": "Hi, I'm interested in partnering..."
}Google Workspace Integration
When you connect Gmail, you also get access to:
Troubleshooting
"Access denied" or permission error
This usually means the OAuth token has expired. Go to Dashboard β Integrations β Gmail and click "Reconnect" to refresh your authorization.
Emails aren't triggering my agent
- Check that your agent is set to "Active" status
- Verify the email matches your trigger filters (labels, sender)
- Check the "Skipped" tab in your agent logs for reasons
- Ensure the email arrived after you connected Gmail
Can I connect multiple Gmail accounts?
Yes! You can connect multiple Gmail accounts and choose which one to use per agent. Go to Integrations and click "Add another account" under Gmail.
Will this work with Google Workspace (business accounts)?
Yes! Both personal Gmail accounts and Google Workspace accounts are supported. Your admin may need to approve third-party app access in the Workspace admin console.