API limits
Table of Contents
API usage limits
Zoho Creator enforces specific limits on API usage based on your subscription plan and the number of user licenses purchased. These limits are designed to ensure optimal performance and fair usage.
The API usage limit is calculated on a daily basis and automatically resets every calendar day, from 00:00 to 23:59 based on Super admin's account timezone.
Types of API limits in Zoho Creator
Zoho Creator categorizes API usage limits into two distinct types.
- Developer API Limit - This limit applies to all standard REST API calls made to Zoho Creator APIs.
- Custom API limit - This limit is applicable for executing Custom APIs created in your Creator account.
Below table outlines the API limits for each plan:
| Plan | Developer API Limits | Custom API Limits |
|---|---|---|
| Free Edition | 250 /day | 100 /day |
| Standard | 250 /user/day | 100 /user/day |
| Professional | 500 /user/day | 250 /user/day |
| Enterprise | 1000 /user/day | 500 /user/day |
| Zoho One | 1000 /user/day | 500 /user/day |
Increase API limits
When your organization reaches the API limit for the day, further API calls will not be processed until the next reset period (00:00). If you require additional API calls, you can purchase the required number of API limits by upgrading your account from the Billing page. This can be performed by the super admins and admins.
API Limit Calculator
Developer API Limit
0
Custom API Limit
0
Other ways API limits are consumed
Apart from the direct API usage, there are other cases within Creator that consumes API limit indirectly.
They are:
- Zoho Creator integration tasks in Deluge
- invoke URL
Zoho Creator integration tasks in Deluge
Integration tasks in Deluge acts as a wrapper of API, that internally triggers the API to execute the pre-defined action. Thus, when you call a Creator integration task, it calls the respective Creator API. Each call to the Zoho Creator's integration task consumes one Developer API call.
For example, the Deluge task zoho.creator.getRecords invokes Zoho Creator's Get Records API internally, thus consuming one Developer API call.
invokeURL task
When you use the invokeURL task in Deluge scripts to call the Zoho Creator APIs or the Custom APIs, each request consumes one API call. In addition to this, each call will also be counted towards External Calls.
- If the request URL in the task calls a Creator API, it reduces Developer API limit by one.
- If the request URL in the task calls a Custom API, it reduces the Custom API limit by one.
Using the above Deluge tasks within loops can quickly multiply API usage and consume your daily quota. Ensure loops are optimized to prevent exceeding your API limits.
Throttle limits
Throttle limit
Throttle limit denotes the maximum number of API calls that can be requested/initiated for a specific duration. Zoho Creator allows 50 API calls per user per minute.
For example, if a user triggers 25 APIs from their own organization and 25 APIs from another organization they've been added to, the total limit of 50 APIs per minute is reached, irrespective of the account/organization.
For publish APIs, this limit is applied per IP address.
Limit: 50 API calls per minute
Scope: Applied per user
Duration: One minute window
Status code: 429
Error response:
"code": 2955,
"message": "You have reached your API call limit for a minute. Please try again after some time."
}
Concurrent throttle limit
Concurrent throttle limit denotes the maximum number of API calls that can be initiated or processed simultaneously. Zoho Creator allows 6 API calls per account.
For publish APIs, this limit is applied per IP address.
Limit: Six concurrent API calls per account
Status code: 429
Error response:
"code": 2955,
"message": "You have reached the maximum number of API calls that can be simultaneously initiated at a time. Please wait for a while and try again."
}