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: explain why an unwired Gmail endpoint leaves triggers silent
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Anshu Garg committed
Nov 5, 2026 at 16:36 UTC
e82d58f72757201b6f1138d74e576c6dc1281753
1 file changed
+2
-2
docs/content/changelog/11-05-26-gmail-google-calendar-instant-triggers.mdx
+2
-2
@@ -53,12 +53,12 @@ Gmail delivers mailbox changes through Google Cloud Pub/Sub, so your app needs a
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.
54
55
<Callout type="warn">
56
-Once the endpoint is complete, every new Gmail trigger you create without `type` uses the webhook right away. If the Pub/Sub push subscription isn't delivering to the endpoint's `webhook_url` yet, those triggers fire nothing, and no error tells you.
56
+**Composio can't see your Google Cloud setup.** It treats the endpoint as ready as soon as it holds every field, and from then on, new Gmail triggers you create without `type` use the webhook. If your Pub/Sub push subscription doesn't deliver to the endpoint's `webhook_url` yet, Gmail's changes never reach Composio. Those triggers stay silent, and no error tells you. The rollout below avoids this.
57
</Callout>
58
59
For a smooth, test-first rollout:
60
61
1. Create Gmail triggers with `type: "poll"` while you set up, so the switch can't catch you halfway.
62
-2. Create the webhook endpoint, fill every field, and create the Pub/Sub push subscription that delivers to its `webhook_url`.
62
+2. Create the webhook endpoint, create the Pub/Sub push subscription that delivers to its `webhook_url`, then fill every field on the endpoint.
63
3. Create a few test triggers with `type: "webhook"`, send yourself an email, and watch the event arrive.
64
4. Switch new triggers to `type: "webhook"`, or drop `type`. Recreate your existing polling triggers to move them over.