Skip to content

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: add lookahead changelog for polling interval changes

Jayesh Sharma5331a896924b
diff --git a/docs/content/changelog/03-03-26-polling-interval-changes.mdx b/docs/content/changelog/03-03-26-polling-interval-changes.mdx
new file mode 100644
index 000000000..9b9903a38
--- /dev/null
+++ b/docs/content/changelog/03-03-26-polling-interval-changes.mdx
@@ -0,0 +1,83 @@
+---
+title: "Polling Trigger Interval Changes - Lookahead Announcement"
+description: "Default polling interval increasing from 1 minute to 15 minutes, with silent clamping during transition"
+date: "2026-03-03"
+---
+
+We're updating **polling trigger intervals** to improve platform reliability and reduce unnecessary API load. This change affects how frequently polling triggers execute.
+
+## What's Changing?
+
+### Default Polling Interval
+
+The default polling interval for triggers is increasing from **1 minute** to **15 minutes**.
+
+If you don't specify an `interval` in your trigger configuration, your triggers will now poll every 15 minutes instead of every 1 minute.
+
+### Minimum Polling Interval
+
+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.
+
+**Example:**
+
+```python
+# Before: this would poll every 5 minutes
+composio.triggers.enable(
+ trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
+ connected_account_id="ca_xxx",
+ config={"interval": 5}
+)
+
+# After: interval is silently clamped to 15 minutes
+composio.triggers.enable(
+ trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
+ connected_account_id="ca_xxx",
+ config={"interval": 5} # Effective interval: 15 minutes
+)
+```
+
+### Current Behavior (Transition Period)
+
+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. A warning is logged when clamping occurs.
+
+### Upcoming Enforcement (~2 Weeks)
+
+After the transition period, requesting an interval below the minimum will return an **API error** instead of silently clamping. You will need to update your trigger configurations to use an interval of 15 minutes or higher.
+
+```python
+# This will return an error after enforcement begins
+composio.triggers.enable(
+ trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
+ connected_account_id="ca_xxx",
+ config={"interval": 5} # Error: interval must be >= 15 minutes
+)
+```
+
+## Why This Change?
+
+1. **Platform Reliability**: Reducing polling frequency decreases load on both Composio infrastructure and third-party APIs
+2. **Rate Limit Protection**: Many third-party APIs have rate limits that are easily hit with 1-minute polling across many triggers
+3. **Cost Efficiency**: Less frequent polling reduces infrastructure costs, keeping the platform sustainable
+
+## What You Need to Do
+
+1. **Review your trigger configurations** — check if any triggers use intervals shorter than 15 minutes
+2. **Update intervals** to 15 minutes or higher before enforcement begins
+3. **If you need near-real-time events**, consider using **webhook triggers** instead of polling triggers where available
+
+## Rollout Timeline
+
+- **March 2026**: Silent clamping enabled — intervals below 15 minutes are automatically raised to 15 minutes
+- **Mid-March 2026**: API enforcement — intervals below 15 minutes will return an error
+- **Frontend enforcement**: The dashboard will prevent setting intervals below 15 minutes
+
+<Callout type="info">
+Existing triggers with intervals below 15 minutes will continue to function during the transition period, but at the clamped 15-minute interval. We recommend updating your configurations proactively.
+</Callout>
+
+## Need Help?
+
+If you have questions about this change or need assistance:
+- Join our [Discord community](https://discord.gg/composio)
+- Check our [documentation](https://docs.composio.dev)
+- Contact support at [email protected]