Zoho API limits
What happens when Zoho's API limit is reached, why syncing pauses, and how to resume it.
Zoho limits how many API calls an organisation can make, per minute and per day. The daily number depends on your Zoho plan. A busy sale day, or a large backfill, can reach it.
Zync is built so that reaching the limit delays your sync and does not break it.
What you see
A banner appears on every page of the app:
Zoho API limit reached. Syncing is paused and resumes on its own in about 12 min; nothing is lost. If you have raised or reset your Zoho limit, resume now.
What happens
| When | Zync |
|---|---|
| Zoho refuses a call because of the limit | Notes how long Zoho asked it to wait and pauses syncing for your store |
| While paused | Holds jobs back. Orders are queued to run again after the pause, not marked as failed |
| The pause ends | Carries on by itself. Waiting jobs restart a little apart from each other, so they do not hit the limit again all at once |
How long the pause lasts:
- When Zoho says how long to wait, that long.
- For a per-minute limit, about a minute.
- For a daily limit, about an hour at a time, until Zoho accepts calls again.
An order can wait out a long pause, including a daily limit that lasts for hours. Nothing is dropped.
Product, customer and inventory jobs use the normal three retries. If a pause outlasts them, they appear as Failed in Logs and you can sync them again once the limit has reset.
Resume now
If you have raised your Zoho limit, or you know it has reset, click Resume now in the banner. Zync starts calling Zoho again straight away. If the limit is still in force, Zoho says so and the pause returns.
Using fewer API calls
- Spread out large backfills. Run a month at a time, not a year.
- Link your products first. An order line whose variant is already linked to a Zoho item needs no search. Run product sync or AI matching before a big order backfill.
- Map your taxes. A mapped tax is used directly.
- Choose a sensible inventory interval. A scheduled inventory sync every few minutes uses far more calls than one every hour.
- Check your Zoho plan's limit in Zoho if you reach it often.
Other apps share the limit
The limit belongs to your Zoho organisation, not to Zync. Other integrations connected to the same organisation use the same allowance.