Unused Composio allowance does not prevent a provider from rejecting a request.
Rate limits by plan
Rate limit headers
Every response includes headers so you can track usage without guessing:Rate limit response
When you exceed the rate limit, you’ll receive a429 Too Many Requests response:
Best practices
- Watch
X-RateLimit-Remaining. Read it on each response to know how much headroom you have left in the window. - Honor
Retry-After. On a Composio429, wait the number of seconds it gives you before retrying. - Cache what doesn’t change. Keep tool definitions and other static data client-side so you don’t spend requests re-fetching them.
Provider quota errors
Providers can limit an OAuth app, developer token, workspace, account, or individual API operation. With managed auth, some of those quotas are shared across connections using Composio’s provider credentials. These errors identify provider limits:
Follow the provider’s retry or reset window. A short burst limit and an exhausted daily or monthly quota need different recovery steps. Repeated retries do not increase the available quota.
Upgrading your Composio plan alone does not move an existing managed connection to a different provider app or dedicated quota. Reconnecting the same managed connection does not switch it to your own OAuth app either.
On the Developer Platform, you can create a custom auth config with your own provider credentials where supported. Authorize a new connected account under that config and select it in your workflow. The provider’s approval requirements and limits still apply. Google Ads, for example, uses a developer token in addition to an OAuth client ID and secret.
Auth configs belong to a project. A custom config in your Developer Platform project does not change an existing Composio For You connection.
If you need help tracing a limit, include the UTC timestamp, tool slug, Composio execution or request ID, provider request ID, exact error, and whether you use managed or custom auth. Keep credentials out of the report.
Need higher limits?
If you regularly hit Composio’s organization API limit, upgrade your plan or talk to us about custom limits. For a provider quota, use the provider recovery steps above.Errors
Understanding API error responses
Pricing
Compare plans and limits