Rate limits apply when making API requests and adding account information in the dashboard.
Platform Rate Limits
API and dashboard rate limits. These limits apply to all endpoints except for endpoint listed for concurrent and IP address.
|Application||General||Allows up to 500 requests per endpoint.||1 s|
|Email Account||General||Allows up to 50 requests per endpoint.||1 s|
Concurrent Rate Limits
|Account||Concurrent||Allows up to 10 concurrent requests.||/delta/streaming|
|Account||Concurrent||Allows up to 10 concurrent requests.||/delta/longpoll|
|Account||Concurrent||Allows up to 5 concurrent requests.||/messages, /threads, or /contacts.|
IP Address Endpoint Rate Limits
GET IP Addresses endpoint has it's own rate limits.
|Application||General||Allows up to 10 requests per endpoint.||1 hr|
Provider Rate Limits
Something to keep in mind while building your application are provider rate limits. When you make an API request to Nylas, we will also attempt to update the provider with that information. Providers have their own rate limits.
We rate limit in two ways, by application and by account. This scope indicates that the rate limit applies either to the entire application, or to an individual connected account. For accounts, the rate limit is applied to the
access_token used to make the query.
If you receive a
429 response from Nylas, we'll include information about why the request was rate-limited, as well as more information about how long you should wait till you make the next request.
We include two headers,
X-RateLimit-Reset for a
429 response that will indicate the rate limit and the time in seconds until the rate limit expires:
Sample 429 Response Headers
We also include helpful information in the response body to indicate which type of rate limit was applied.
Sample 429 Response Body
'message': 'Too many requests',
Rate Limit Messages
Possible rate limit messages include:
|"Too many requests from this application"||You've reached the application rate limit|
|"Too many requests"||You've made too many requests to a single endpoint for the account|
|"Too many concurrent streaming requests"||You've made too many concurrent requests to the deltas endpoints for the account|
|"Too many concurrent query requests"||You've made too many concurrent requests to