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: say when polling_interval is checked
Composio checks it up front only when type is omitted, since the trigger may fall back to polling. An explicit webhook type doesn't use it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Anshu Garg committed
Nov 5, 2026 at 16:31 UTC
56475ab1cefa63b39e9e100aca30f639bdd7a6c4
2 files changed
+2
-2
docs/content/changelog/11-05-26-gmail-google-calendar-instant-triggers.mdx
+1
-1
@@ -31,7 +31,7 @@ What just happened? The trigger supports both webhooks and polling, so Composio
31
- **Instant Gmail triggers.** `GMAIL_NEW_GMAIL_MESSAGE` and `GMAIL_EMAIL_SENT_TRIGGER`.
32
- **Instant Google Calendar triggers.** `GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGER`, `GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGER`, `GOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGER`, `GOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGER`, and `GOOGLECALENDAR_ATTENDEE_RESPONSE_CHANGED_TRIGGER`. `GOOGLECALENDAR_EVENT_STARTING_SOON_TRIGGER` keeps polling, because it fires on a schedule relative to each event's start time.
33
- **Choose webhook or polling.** Pass `type` as `"webhook"` or `"poll"`. Omit it and Composio uses a webhook whenever it can set one up.
34
-- **`polling_interval`.** Set the minutes between polls with this top-level parameter (`pollingInterval` in TypeScript). It applies when you pass `type: "poll"`, and when a trigger falls back to polling. Composio checks it even when the trigger ends up on a webhook, so a value outside the toolkit's allowed range fails the request.
34
+- **`polling_interval`.** Set the minutes between polls with this top-level parameter (`pollingInterval` in TypeScript). It applies when you pass `type: "poll"`, and when a trigger falls back to polling. When you omit `type`, Composio checks it before it tries the webhook, in case the trigger falls back, so a value outside the toolkit's allowed range fails the request.
35
- **`fallback_reason`.** When a trigger polls because Composio couldn't set up its webhook, `fallback_reason` says what's missing.
36
37
Python `composio` 0.31.0 and TypeScript `@composio/core` 0.28.0 support `type` and the polling interval. See the [SDK release notes](/docs/changelog/2026/11/03).
docs/content/docs/setting-up-triggers/creating-triggers.mdx
+1
-1
@@ -181,7 +181,7 @@ curl -X POST https://backend.composio.dev/api/v3.1/trigger_instances/GMAIL_NEW_G
181
182
Omit `type` to let Composio choose. The response reports what the instance uses. Composio sets `fallback_reason` when the instance polls because it couldn't set up a webhook, for example when your own OAuth app has no [webhook endpoint](/docs/setting-up-triggers/custom-oauth-webhooks) yet.
183
184
-Composio checks `polling_interval` whenever the instance could poll, so a value outside the toolkit's allowed range fails the request even when the instance ends up on a webhook.
184
+When you omit `type`, Composio checks `polling_interval` before it tries the webhook, in case the trigger falls back to polling, so a value outside the toolkit's allowed range fails the request. With `type: "webhook"`, Composio doesn't use it.
185
186
## Next
187