User's UI actions are counted in the rate limit. Webhooks are not subjected to rate limiting.
All our API endpoints require authentication. Regardless of the authentication method, the Pipedrive API allows performing requests according to the plan.
While the Pipedrive API rate limit window duration is 2 seconds for both authentication methods, the rate limiting of the Pipedrive API is different for api_token
requests and OAuth apps using access_token
.
Rate limiting of the Pipedrive API is considered per token, not per company.
See below how each of our four plans offers different rate limiting per 2-second window for both authentication methods:
Essential
20 requests per 2 seconds per api_token
Advanced
40 requests per 2 seconds per api_token
Professional
80 requests per 2 seconds per api_token
Enterprise
120 requests per 2 seconds per api_token
Essential
80 requests per 2 seconds per access_token
Advanced
160 requests per 2 seconds per access_token
Professional
320 requests per 2 seconds per access_token
Enterprise
480 requests per 2 seconds per access_token
Each Pipedrive API request will include the following rate limit response headers:
x-ratelimit-limit
The maximum number of requests current access_token
or api_token
can perform per 2-second window.
x-ratelimit-remaining
The number of requests left for the 2-second window.
x-ratelimit-reset
The remaining window before the rate limit resets.
x-daily-requests-left
Indicates how many requests you can still make to POST
/PUT
endpoints during the ongoing day (calculated in UTC). Applicable only to api_token
requests. See more here.
For example, after a successful request has been made from an Advanced plan account, the API response headers would look like this:
x-ratelimit-limit: 40
x-ratelimit-remaining: 39
x-ratelimit-reset: 2
x-daily-requests-left: 9999
If you exceed the rate limit, our API will start rejecting your requests and you'll receive an error response of HTTP 429 "Too Many Requests" in the body:
{"success":false,"error":"request over limit","errorCode":429}
In addition to rate limiting, public API has a daily API fair usage limit for all POST/PUT endpoints. Fair usage is considered to be a maximum of 10 000 POST/PUT requests daily per user per 24 hours. The daily limit will be reset at midnight in UTC.
Martin is a user of Pipedrive. He has two custom integrations using the Pipedrive API. Both custom integrations are subject to the same daily limit to make requests against the Pipedrive API on behalf of the user, Martin. So, for example, if one of those integrations is making 350 POST requests per day and the other integration 100 PUT requests each per day, then there's 10000 - 350 - 100 - 100 = 9450 POST/PUT requests left for those two integrations to use for the remaining time until the reset.
The x-daily-requests-left
in the response header will indicate how many requests you can still make to POST/PUT endpoints during the ongoing day. See how the full header would look like in HTTP headers and response codes.
We strongly recommend integrations built using api_token
and apps using OAuth 2.0 to follow the daily fair usage limit of 10000 POST/PUT requests.
In the case of exceeding the 10 000 daily limit on multiple occasions, we may start blocking your POST/PUT requests towards our API.
If you're reaching the rate limit, options to improve performance include restructuring the architecture of the integration, using Webhooks, and/or upgrading to Advanced, Professional or Enterprise plan.
Updated 2 months ago
Further reading
Responses |