Composio Gmail and Google Calendar triggers now fire in real time; interval is deprecated (November 12, 2026)
New Gmail and Calendar triggers use webhooks, not polling. Old triggers keep polling until recreated. Use polling_interval, not interval.
Your keys
0 of 1 ready
Create each key on its own page, paste it below, then copy the finished lines into your project's .env file. What you paste stays in this tab. It is never sent to Wirestack or saved.
- Composio API keyCOMPOSIO_API_KEYGet key
Copy your project API key from Settings, API keys in the Composio dashboard.
What changed
On November 12, 2026 Composio made new Gmail and Google Calendar triggers real time. Google tells Composio about a new email or a changed event as it happens, and the event reaches your webhook URL in seconds, in the same payload shape as before.
- Real time now:
GMAIL_NEW_GMAIL_MESSAGE,GMAIL_EMAIL_SENT_TRIGGER,GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGER,GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGER,GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGER,GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGERandGOOGLECALENDAR_ATTENDEE_RESPONSE_CHANGED_TRIGGER. - Still polling:
GOOGLECALENDAR_EVENT_STARTING_SOON_TRIGGER. - Existing triggers are not moved. They keep polling. To switch one, delete it and create it again.
- New
typeparameter:"webhook"or"poll". Leave it out and Composio uses a webhook whenever it can set one up. - New
polling_intervalparameter at the top level (pollingIntervalin TypeScript): minutes between polls. - Deprecated:
intervalinsidetrigger_config. It keeps working when you do not passpolling_interval. - The response now includes
typeandfallback_reason, which says what is missing when a trigger had to fall back to polling. - Python
composio0.31.0 and TypeScript@composio/core0.28.0 supporttypeand the polling interval.
With Composio-managed auth there is nothing to set up. With your own OAuth app, Google Calendar works as it is, but Gmail needs a Google Cloud Pub/Sub topic and push subscription in the project that owns your OAuth client. Until that is done, new Gmail triggers poll.
