Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs: link the Gmail setup line to the Gmail FAQ
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Anshu Garg committed
Nov 5, 2026 at 16:39 UTC
e5dff47078992a4682dcf151d2dd58a6f0262c89
1 file changed
+1
-1
docs/content/changelog/11-05-26-gmail-google-calendar-instant-triggers.mdx
+1
-1
@@ -50,7 +50,7 @@ Google Calendar works on your own Google OAuth app with no extra setup.
50
51
Gmail delivers mailbox changes through Google Cloud Pub/Sub, so your app needs a topic and a push subscription in the Google Cloud project that owns your OAuth client. Each Gmail trigger's description walks you through it. Read it with `composio.triggers.get_type("GMAIL_NEW_GMAIL_MESSAGE")` in Python, `composio.triggers.getType('GMAIL_NEW_GMAIL_MESSAGE')` in TypeScript, or `GET /api/v3.1/triggers_types/GMAIL_NEW_GMAIL_MESSAGE`.
52
53
-Setup is complete once your Gmail [webhook endpoint](/docs/setting-up-triggers/custom-oauth-webhooks) exists and holds every field: `topic_name`, `push_service_account_email`, and `push_audience`. Until then, new Gmail triggers keep polling, and `fallback_reason` tells you which piece is missing. Nothing breaks while you set up.
53
+Setup is complete once your Gmail webhook endpoint exists and holds every field the [Gmail FAQ](/toolkits/gmail) lists: `topic_name`, `push_service_account_email`, and `push_audience`. Until then, new Gmail triggers keep polling, and `fallback_reason` tells you which piece is missing. Nothing breaks while you set up.
54
55
<Callout type="warn">
56
**A note on timing.** Composio can't look inside your Google Cloud project, so it treats your endpoint as ready as soon as you've filled in every field. From then on, new Gmail triggers you create without `type` use the webhook. If your Pub/Sub push subscription isn't delivering to the endpoint's `webhook_url` yet, Gmail's changes won't reach Composio, and those triggers will stay quiet with no error to tell you why. The rollout below keeps you on polling until you've seen an event arrive.