Mar 11, 2026

We're updating polling trigger intervals to improve platform reliability and avoid rate limiting. 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.

# 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
)

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.

Enforcement (April 15, 2026)

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
)

App-Level Interval Overrides

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.

Need Intervals Below 15 Minutes?

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.

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 April 15, 2026
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

Rollout Timeline

• March 11, 2026: Silent clamping enabled — intervals below 15 minutes are automatically raised to 15 minutes
• April 15, 2026: API enforcement — intervals below 15 minutes will return an error
• April 15, 2026: Dashboard enforcement — the UI will prevent setting intervals below 15 minutes