@devries-cameron20 / composio Mirror · read-only / commits / b4e508204
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 06:00 UTC

docs: say how to save the Gmail Pub/Sub values on the endpoint

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Anshu Garg committed Nov 5, 2026 at 16:30 UTC b4e50820483a968be0134504b18d2de0d5c3f7d4
1 file changed +1 -1
docs/content/toolkits/faq/gmail.md
+1 -1
@@ -43,7 +43,7 @@ Gmail delivers mailbox changes through Google Cloud Pub/Sub. Set it up once per
43 3. Create a service account only for push deliveries, for example `composio-gmail-push`. Give it no roles and create no keys: Pub/Sub uses it only to sign each push.
44 4. [Create a Gmail webhook endpoint](/docs/setting-up-triggers/custom-oauth-webhooks) with your OAuth client ID, and note its `webhook_url`.
45 5. Create a push subscription on the topic. Set its endpoint URL to the `webhook_url`, turn on authentication with the service account, and set the audience to the same `webhook_url`. Leave payload unwrapping off, and set the subscription to never expire.
46 -6. On the endpoint, set `topic_name` to the topic's full name, `push_service_account_email` to the service account's email, and `push_audience` to the `webhook_url`.
46 +6. Share your Pub/Sub details with Composio by [updating the endpoint](/docs/setting-up-triggers/custom-oauth-webhooks#updating-an-endpoint), a `PATCH` or `composio.webhooks.endpoints.update()` in the SDKs. Set `topic_name` to the topic's full name, `push_service_account_email` to the service account's email, and `push_audience` to the `webhook_url`.
47
48 Until the endpoint has all three fields, new Gmail triggers poll, and their `fallback_reason` says what's missing. Once it does, new triggers you create without `type` use the webhook straight away. That's why the fields come last, after the push subscription is delivering.
49