API Limits

Credit System

API calls in Zoho CRM are associated with credits. The credits are deducted from your credit count, based on the type of the API call that you make. Credit deduction is based upon the intensiveness of the performance, and the memory usage of the operations involved in the API calls.

Each API call made will result in a reduction of 1 credit. However, for some APIs, credit reduction would be different. For example, for a "Convert Lead API", 5 credits will be reduced for a single API call. Refer to the table below for more details.

Maximum credit limit in a 24-hour window for various editions of Zoho CRM

EditionAllowed CreditsMaximum Credits
Free Edition5000 credits5000 credits
Standard/Starter Edition5,000 credits + (Number of User licenses x 250) + Add-on credits100,000 credits
Professional10,000 credits + (Number of User licenses x 500) + Add-on credits500,000 credits
Enterprise/Zoho One15,000 credits + (Number of User licenses x 1000) + Add-on credits1,000,000 credits
Ultimate/CRM Plus15,000 credits + (Number of User licenses x 2000) + Add-on creditsUnlimited

Here is a calculator to know the available credit limits based on your edition and the number of users.




With the purchase of 100 users for Enterprise/ZohoOne edition, the available API Credits are 115,000

 

Note:

  • For example, in the Standard edition, if there are 10 user licenses in an organization, the available credits will be 7500 (i.e, 5000 + (10 x 250)). However, the maximum limit for this edition will still be 100,000 credits irrespective of the number of user licenses.

  • For all editions, factors such as concurrency and sub-concurrency are placed to protect the service from overload. This will impact the total number of API calls we process in the 24-hour rolling window.

Add-on Credits

If your organization requires more API credits than the allowed limit for your edition, write to support@zohocrm.com and purchase additional credits.

The below table gives the pricing details for different credit slabs.

Add-on Credits per 24 hoursPrice in $ per 1000 Credits
First 25,0000.14
Next 75,0000.06
Next 150,0000.05
Next 250,0000.025
Note
  • If you choose to purchase 25,000 add-on credits, the price will be (25,000 x $0.14)/1000 = $3.5. The price per month will be $3.5 x 30 = $105. Similarly, if you want to purchase 75,000 credits, the price will be (25,000 x 0.14)/1000+(50,000 x 0.06)/1000 = $6.5, and the price per month will be $6.5 x 30 = $195.

  • If you want to purchase 100,000 credits, then you will be charged a total of $240 per month ($105 for 25000 + $135 for 75,000).

  • You can purchase either a maximum of 500,000 extra credits, or the difference between your edition's maximum credit limit and your current API limit, whichever is lower.

Here is a calculator to know the amount payable based on your DC, add-on credits and the payment period.








The total amount payable for 100,000 Add-on credits is 240 US Dollars, billed monthly.

 

The credit deduction for some of the API operations are listed below.

API CallNumber of Credits Deducted
Get Users/Roles/Profiles1
Get list of Modules1
Get Field Meta Data1
Get Module Meta Data1
Get IDs of deleted records2
Get records with cvid parameter3
Convert Lead5
Add/Remove Tags to Multiple records1 credit for every 50 records
Insert/Update/Upsert1 credit for every 10 records
Bulk Read Initialize50
Bulk Write Initialize500
All other APIs1

Note

  • You can Insert/Update/Upsert a maximum of 100 records per API call, and Add/Remove Tags from a maximum of 500 records per API call. Therefore, the maximum number of credits that the system deducts for these API calls is 10.

  • The API call limit has a rolling 24 hours window, from the start of the call.

Concurrency limits for various editions of Zoho CRM

In addition to the above credit system, Zoho CRM also uses a Concurrency system, to calculate API Limits based on the number of concurrent calls made per user per app in Zoho CRM. These concurrency limits specify the maximum number of API calls that can be simultaneously active at a given point of time for a user per app.

Since the API limits are based on the number of simultaneous active calls, there are no time-based API call restrictions in Zoho CRM. You can make any number of API calls in a minute, provided the number of concurrent calls are within the specified limits.

EditionConcurrency Limits for a User/App
Free5
Standard/Starter10
Professional15
Enterprise/Zoho One20
Ultimate/CRM Plus25

Sub-concurrency limits for various editions

Besides concurrency limits, Zoho CRM also applies sub-concurrency to limit the number of concurrent calls for the following APIs:

  • Get Records with cvid or sort_by parameters

  • Convert Lead

  • Insert, Update, or Upsert records (when the record count is greater than 10)

  • Search records API invoked from a function

  • Query API

The sub-concurrency limit for the above APIs is 10 for all the CRM editions. For example, you can either make ten concurrent Convert Lead API calls or a combination of 10 concurrent requests of any of the above APIs.

Therefore, when a user makes an API request, two concurrency limits are applied—Concurrency (edition-based) and Sub-concurrency (request-based).

For example, let's consider that a user in the Professional edition makes a Convert Lead API call. The concurrency limit the user is left with is 14 (out of 15), and the sub-concurrency limit for the Convert Lead request is 9 (out of 10). These limits are further calculated based on the type of subsequent requests.

Let's say the user calls the Get Module Meta Data API. Now, the concurrency limit becomes 13 (out of the remaining 14), and the sub-concurrency limit stays the same (9).
Now, the user updates 15 records through the Update records API. The concurrency limit, now, is 12 (out of the remaining 13), and the sub-concurrency limit for the same is 8 (out of the remaining 9).
After this, the user can make only 7 concurrent calls-—Convert lead, insert/update (more than 10 records), search records from a function, or query API.

When the sub-concurrency limit for any of the two requests is reached, the system throws an error.

The user can, however, continue to make other requests as they still fall under the primary concurrency limit.