Overview
Use the Gmail Trigger to kick off your deployed crews when Gmail events happen in connected accounts, such as receiving a new email or messages matching a label/filter.Make sure Gmail is connected in Tools & Integrations and the trigger is enabled for your deployment.
Enabling the Gmail Trigger
- Open your deployment in CrewAI AMP
- Go to the Triggers tab
- Locate Gmail and switch the toggle to enable

Example: Process new emails
When a new email arrives, the Gmail Trigger will send the payload to your Crew or Flow. Below is a Crew example that parses and processes the trigger payload.Sample payloads & crews
The CrewAI AMP Trigger Examples repository includes:new-email-payload-1.json
/new-email-payload-2.json
— production-style new message alerts with matching crews innew-email-crew.py
thread-updated-sample-1.json
— follow-up messages on an existing thread, processed bygmail-alert-crew.py
Monitoring Executions
Track history and performance of triggered runs:
Payload Reference
See the sample payloads and field descriptions:Gmail samples in Trigger Examples Repo
Gmail samples in Trigger Examples Repo
Troubleshooting
- Ensure Gmail is connected in Tools & Integrations
- Verify the Gmail Trigger is enabled on the Triggers tab
- Check the execution logs and confirm the payload is passed as
crewai_trigger_payload