docs/content/changelog/03-11-26-polling-interval-changes.mdx
We're updating polling trigger intervals to improve platform reliability and avoid rate limiting. This change affects how frequently polling triggers execute.
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.
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.
# Before: this would poll every 5 minutes
composio.triggers.enable(
trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
connected_account_id="ca_xxx",
config={"interval": 5}
)
# Now: 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
)
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.
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.
# This will return an error after April 15, 2026
composio.triggers.enable(
trigger_name="GMAIL_NEW_GMAIL_MESSAGE",
connected_account_id="ca_xxx",
config={"interval": 5} # Error: interval must be >= 15 minutes
)
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.
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.