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