@devries-cameron20 / composio Mirror · read-only / commits / 8eaacbe58
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: keep the Gmail switch-over steps in the changelog only

The custom OAuth webhooks page already covers endpoint setup generically, and each Gmail trigger's description lists its Pub/Sub steps. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Anshu Garg committed Nov 5, 2026 at 15:29 UTC 8eaacbe587816d867b7814191c56f61467e2351d
2 files changed -20
docs/content/docs/setting-up-triggers/custom-oauth-webhooks.mdx
-19
@@ -160,25 +160,6 @@ Paste the `webhook_url` from step 2 into the provider's app dashboard:
160
161 For providers that issue a verification challenge on save (Slack `url_verification`, Notion's verification token, and so on), Composio responds automatically, with no handshake code on your side. Once the provider accepts the URL, go [create your trigger](/docs/setting-up-triggers/creating-triggers).
162
163 -## Gmail push notifications
164 -
165 -Gmail delivers mailbox changes through Google Cloud Pub/Sub instead of a request URL on your OAuth app. You create a topic and a push subscription in the Google Cloud project that owns your OAuth client. Each Gmail trigger's description lists the steps; read it with `composio.triggers.get_type("GMAIL_NEW_GMAIL_MESSAGE")` in Python or `composio.triggers.getType('GMAIL_NEW_GMAIL_MESSAGE')` in TypeScript. The Gmail endpoint takes three fields: `topic_name`, `push_service_account_email`, and `push_audience`.
166 -
167 -Until the endpoint exists with all three fields, new Gmail triggers poll, and their `fallback_reason` names what's missing.
168 -
169 -<Callout type="warn">
170 -**New Gmail triggers switch to the webhook as soon as the endpoint is complete.** Once all three fields are set, every new Gmail trigger you create without `type` uses the webhook. If the Pub/Sub push subscription isn't delivering to the endpoint's `webhook_url` by then, those triggers receive nothing and report no error.
171 -</Callout>
172 -
173 -To switch over without missing an email:
174 -
175 -1. Pass `type: "poll"` when you create Gmail triggers, so new triggers keep polling while you set up.
176 -2. Create the endpoint, fill all three fields, and create the Pub/Sub push subscription that delivers to its `webhook_url`.
177 -3. Create a few test triggers with `type: "webhook"`, send yourself an email, and confirm the events arrive.
178 -4. Pass `type: "webhook"`, or drop `type`, for new triggers. An existing trigger keeps polling until you delete it and create it again.
179 -
180 -See [Choosing webhook or polling](/docs/setting-up-triggers/creating-triggers#choosing-webhook-or-polling) for `type` and `polling_interval`.
181 -
163 ## Updating an endpoint
164
165 To rotate the signing secret or update any single field, `PATCH` it (other fields are preserved):
docs/content/docs/setting-up-triggers/troubleshooting.mdx
-1
@@ -32,7 +32,6 @@ Use the trigger logs to locate the first missing step:
32 | A trigger event exists, but your app receives nothing | Inspect the project's outbound webhook subscription, destination URL, enabled events, and delivery response. |
33 | Your app receives a request, but the handler rejects it | Check the signing secret, raw request body, timestamp, and handler logs using [signature verification](/docs/setting-up-triggers/subscribing-to-events#verifying-signatures). |
34 | A Gmail or Google Calendar trigger polls instead of using a webhook | [List the trigger](/docs/setting-up-triggers/managing-triggers#listing-active-triggers) and read its `type` and `fallback_reason`. `fallback_reason` names what the webhook setup is missing. |
35 -| A Gmail webhook trigger on your own OAuth app receives nothing | Check that the Pub/Sub push subscription delivers to the endpoint's `webhook_url`, with the service account and audience set on the endpoint. See [Gmail push notifications](/docs/setting-up-triggers/custom-oauth-webhooks#gmail-push-notifications). |
35
36 Your outbound subscription must include `composio.trigger.message`. A toolkit's trigger slug is not a webhook subscription event type. See [project subscriptions](/docs/setting-up-triggers/subscribing-to-events#manage-project-subscriptions).
37