Only show these results:

Rate Limiting

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.

Scope Type Rate-limit Expiration
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

Scope Type Rate-limit Endpoint
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.

Scope Type Rate-limit Expiration
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.

Scope

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.

Expiration

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-Limit and 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 

{
  'X-RateLimit-Limit': '500', 
  'X-RateLimit-Reset': '10', 
}

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', 
  'type': 'invalid_request_error'
}

Rate Limit Messages

Possible rate limit messages include:

Message Descriptions
"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 /messages and /threads for the account