@devries-cameron20 / composio-1 / commits / ff19f3a65
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.

docs: announce realtime Gmail and Google Calendar triggers (#5233)

## What this announces Gmail and Google Calendar triggers can now receive events in realtime by webhook instead of waiting for the next poll. The entry is written for three readers, triaged in the first lines: Composio-managed auth (nothing to do), existing triggers (not migrated, delete and recreate), and custom Google OAuth apps (Calendar needs nothing, Gmail needs Pub/Sub). ## Structure - `changelog/11-12-26-gmail-google-calendar-realtime-triggers.mdx`: the announcement, on the `docs-decisions` changelog template and the `good-docs-writing` voice. It opens with a managed-auth cURL example and its response. Then come `### What's new` (supported slugs, `type`, `polling_interval`, `fallback_reason`) and a deprecation callout for `trigger_config.interval`. The last two sections cover existing triggers and custom OAuth apps; the Gmail part has a warning callout for silent triggers and a four-step test-first rollout. - `docs/triggers.mdx`: Gmail and Google Calendar move to the realtime examples. The page no longer says delivery kind can't be configured, and 2 minutes is described as the default polling interval rather than a minimum. - `setting-up-triggers/creating-triggers.mdx`: new "Choosing webhook or polling" section with Python, TypeScript, and API examples for `type` and `polling_interval`. - `setting-up-triggers/custom-oauth-webhooks.mdx`: less tied to Slack. For triggers that support both webhook and polling, `requires_webhook_endpoint_setup` applies to the webhook only. Until the endpoint is set up they poll with a `fallback_reason`. Gmail's fields (saved last, after its push subscription is delivering), signature check, and push subscription sit beside Slack's, and the toolkit FAQ links now include Gmail. - `toolkits/faq/gmail.md`: "Why is my Gmail trigger slow?" now explains when a trigger polls. A new FAQ walks through Gmail Pub/Sub setup on your own OAuth app, with the endpoint fields last so triggers can't switch before pushes are delivering. - `setting-up-triggers/troubleshooting.mdx`: one row for a trigger that polls instead of using a webhook (read `type` and `fallback_reason`), and `interval` becomes `polling_interval`. The one-time switch-over steps and the `interval` deprecation live only in the changelog. The guides describe current behavior and don't mention deprecated fields. Response fields (`type`, `fallback_reason`, `polling_interval`) come from the OpenAPI spec, so the API reference is untouched. ## Before merging The changelog is dated 2026-11-12. Merge on that day, or move the filename and `date` to the day it ships. ## Checks `validate-links`, `check:api-snippets`, `check:code-examples`, `check:python-snippets`, and `check:typescript-snippets` pass. Locally, `bun run test` has 5 failures in `content-freshness.test.ts`; they fail the same way on unmodified `next`. The new TypeScript example type-checks against the installed `@composio/core` 0.28.0. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

Anshu Garg committed Nov 12, 2026 at 16:18 UTC ff19f3a6510f6e34248a239bcab8edc9a3e4e391

No changes.