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, 03:37 UTC
| 1 | --- |
| 2 | title: "Polling Trigger Interval Changes" |
| 3 | description: "Default polling interval increasing from 1 minute to 15 minutes, with silent clamping during transition" |
| 4 | date: "2026-03-11" |
| 5 | --- |
| 6 | |
| 7 | <Callout type="warn"> |
| 8 | **Update (March 13, 2026):** Existing customers have a transition period until May 1, 2026. See [updated changelog](/docs/changelog/2026/03/13). |
| 9 | </Callout> |
| 10 | |
| 11 | We're updating **polling trigger intervals** to improve platform reliability and avoid rate limiting. This change affects how frequently polling triggers execute. |
| 12 | |
| 13 | ## What's Changing? |
| 14 | |
| 15 | ### Default Polling Interval |
| 16 | |
| 17 | The default polling interval for triggers is increasing from **1 minute** to **15 minutes**. |
| 18 | |
| 19 | If you don't specify an `interval` in your trigger configuration, your triggers will now poll every 15 minutes instead of every 1 minute. |
| 20 | |
| 21 | ### Minimum Polling Interval |
| 22 | |
| 23 | A new **minimum polling interval of 15 minutes** is being introduced. Triggers configured with intervals shorter than 15 minutes will be automatically clamped to 15 minutes. |
| 24 | |
| 25 | ```python |
| 26 | # Before: this would poll every 5 minutes |
| 27 | composio.triggers.enable( |
| 28 | trigger_name="GMAIL_NEW_GMAIL_MESSAGE", |
| 29 | connected_account_id="ca_xxx", |
| 30 | config={"interval": 5} |
| 31 | ) |
| 32 | |
| 33 | # Now: interval is silently clamped to 15 minutes |
| 34 | composio.triggers.enable( |
| 35 | trigger_name="GMAIL_NEW_GMAIL_MESSAGE", |
| 36 | connected_account_id="ca_xxx", |
| 37 | config={"interval": 5} # Effective interval: 15 minutes |
| 38 | ) |
| 39 | ``` |
| 40 | |
| 41 | ### Current Behavior (Transition Period) |
| 42 | |
| 43 | During the transition period, intervals below the minimum are **silently clamped** — your triggers will continue to work without errors, but they will run at the minimum interval instead of your requested interval. |
| 44 | |
| 45 | ### Enforcement (April 15, 2026) |
| 46 | |
| 47 | Starting **April 15, 2026**, requesting an interval below the minimum will return an **API error** instead of silently clamping. Update your trigger configurations to use an interval of 15 minutes or higher before this date. |
| 48 | |
| 49 | ```python |
| 50 | # This will return an error after April 15, 2026 |
| 51 | composio.triggers.enable( |
| 52 | trigger_name="GMAIL_NEW_GMAIL_MESSAGE", |
| 53 | connected_account_id="ca_xxx", |
| 54 | config={"interval": 5} # Error: interval must be >= 15 minutes |
| 55 | ) |
| 56 | ``` |
| 57 | |
| 58 | ### App-Level Interval Overrides |
| 59 | |
| 60 | We will also be introducing **app-specific default polling intervals**. Each app will have its own default interval based on the rate limits that app allows and whether the rate limit is per-user or per-app. These app-level defaults may be lower or higher than 15 minutes depending on the app. When you don't specify an `interval`, the app-level default will be used instead of the global 15-minute default. |
| 61 | |
| 62 | ### Need Intervals Below 15 Minutes? |
| 63 | |
| 64 | If you require polling intervals shorter than 15 minutes, you should **use your own OAuth app** (custom auth). With custom auth, the 15-minute minimum does not apply — you can set polling intervals as low as **1 minute**. |
| 65 | |
| 66 | ## What You Need to Do |
| 67 | |
| 68 | 1. **Review your trigger configurations** — check if any triggers use intervals shorter than 15 minutes |
| 69 | 2. **Update intervals** to 15 minutes or higher before **April 15, 2026** |
| 70 | 3. **If you need near-real-time events**, consider using **webhook triggers** instead of polling triggers, or use **custom auth** for intervals as low as 1 minute |
| 71 | |
| 72 | ## Rollout Timeline |
| 73 | |
| 74 | - **March 11, 2026**: Silent clamping enabled — intervals below 15 minutes are automatically raised to 15 minutes |
| 75 | - **April 15, 2026**: API enforcement — intervals below 15 minutes will return an error |
| 76 | - **April 15, 2026**: Dashboard enforcement — the UI will prevent setting intervals below 15 minutes |
| 77 | |
| 78 | <Callout type="info"> |
| 79 | Existing triggers with intervals below 15 minutes will continue to function during the transition period, but at the clamped 15-minute interval. Update your configurations before April 15 to avoid errors. |
| 80 | </Callout> |