What we do
Tools
Industries
Department
How we workLet's talk →
Zoho Inventory

The Zoho API: One Login Flow, Then Zoho Inventory API Calls

Every Zoho product, Inventory, CRM, Books, Desk and the rest, uses the same OAuth 2.0 setup run by Zoho Accounts. Get that right once and the token works for any product your scopes cover. Each product then has its own base URL, endpoints and limits. Here's the token flow, then what Zoho Inventory's API needs on every call.

A working Zoho token, in order

Register a client in the Zoho API Console (api-console.zoho.com). Pick Self Client for a server-side script, or Server-based Applications if users sign in through a redirect. You get a Client ID and Client Secret.

API Console Add Client

Get a grant code with the scopes you need, for example ZohoInventory.items.READ. It's short-lived, so exchange it straight away.

Exchange it by POSTing to /oauth/v2/token on your data center's accounts domain with grant_type=authorization_code. Ask for access_type=offline to get a refresh token.

Call the API with the header Authorization: Zoho-oauthtoken <access_token>. Access tokens last about an hour. Use the refresh token to get a new one.

Your first Zoho Inventory API call

  1. 1

    Use the base URL for your data center

    The root is https://www.zohoapis.com/inventory/v1 for US accounts. Other regions swap the domain: .eu, .in, .com.au, .jp, .ca, .com.cn or .sa. Look at the address bar when you're signed in to Zoho Inventory to see yours.

    Watch for: the accounts domain has to match too. A token from accounts.zoho.com won't work against an EU organization.

  2. 2

    Find your organization_id

    Every Inventory request needs the organization_id parameter. Call GET /organizations with the ZohoInventory.settings.READ scope, or copy it from Manage Organizations in the app.

  3. 3

    Ask for only the scopes you use

    Scopes follow ZohoInventory.<resource>.<CREATE|READ|UPDATE|DELETE>, separated by commas. ZohoInventory.FullAccess.all is easier while testing, but narrow it before the integration goes live.

  4. 4

    Read in pages

    List endpoints such as items and sales orders return results a page at a time. Keep requesting the next page until the response says there are no more, or you'll quietly sync only the first batch.

Why Zoho API calls fail

invalid_code when exchanging the grant code

How you'll know: The token request comes back with invalid_code.

Fix: The code expired or was already used. Generate a new one and exchange it within the time allowed. Also check the redirect URI matches the registered one exactly.

INVALID_TOKEN on a token that looks fine

How you'll know: The access token works in one tool and fails in your code.

Fix: Usually a data center mismatch, an expired token, or the token sent as a URL parameter. Zoho only accepts it in the Authorization header with the Zoho-oauthtoken prefix.

HTTP 429 halfway through a sync

How you'll know: Error 44 (per-minute limit, organization blocked for a while) or error 45 (daily limit reached).

Fix: Zoho Inventory allows 100 requests a minute per organization and a daily cap by plan: 1,000 on Free, 2,000 on Standard, 5,000 on Professional and 10,000 on Premium and Enterprise. Concurrent calls are limited too, 5 on Free and 10 on paid plans. Throttle, and stop re-reading data that hasn't changed.

Refresh tokens that stop working

How you'll know: An old integration suddenly can't refresh after someone re-authorized it a few times.

Fix: Each consent creates a new refresh token, and a user can hold at most 20. Store one refresh token per integration and reuse it instead of re-consenting.

Same token, different Zoho APIs

Most people searching "Zoho API" need one of these. The login flow above is identical; the docs, endpoints and limits aren't.

You want to Use Watch for
Read or change stock, items, sales and purchase orders Zoho Inventory API, on this page organization_id on every call, and the daily cap on lower plans.
Sync leads, contacts and deals Zoho CRM API. See Zoho CRM API CRM limits are counted differently from Inventory's, so a budget for one doesn't carry over.
Push invoices, payments or bills Zoho Books API. See Zoho Books API If you run Books and Inventory together, they share items and contacts. Decide which API owns each write.
Create or update support tickets Zoho Desk API. See Zoho Desk API Desk calls also need the org ID, sent as a header rather than a parameter.

Polling or webhooks

Asking Zoho Inventory every few minutes whether anything changed burns through the daily cap fast, especially across a big catalog. Zoho Inventory can call you instead: set up a workflow rule under Settings, then Automation, then Workflow Rules, and add a webhook as the action. The rule fires on an event, such as a sales order being created or an item being edited, and posts the record to your URL.

Zoho Inventory already connects to channels like Shopify, Amazon and eBay without code, so check the built-in Zoho Inventory integrations before building one. The API is for what those don't cover: your own app, a BI tool, a non-Zoho accounting system, or a warehouse partner. The QuickBooks connection is a common example.

Questions people ask

Does Zoho Inventory have an API?

Yes. It's a REST API covering items, stock, sales orders, purchase orders, packages, shipments, invoices and settings. Its documentation is separate from the other Zoho products, but it uses the same Zoho OAuth tokens.

Is the Zoho API the same across all Zoho apps?

Only the login part. Every app uses Zoho Accounts OAuth, so one client and one token can cover several products if you request their scopes together. Base URLs, endpoints, parameters and rate limits are separate for Inventory, CRM, Books, Desk and the rest.

Do I need a developer to use the Zoho Inventory API?

For a one-off read, someone comfortable with Postman can manage. For a sync that runs every day, you need token refresh, paging, retries, rate limits and field mapping handled properly, which is developer work. n-frames builds and runs Zoho Inventory integrations for businesses that don't have that person in house.

Where do I find my Zoho API key?

There isn't a static API key for current Zoho APIs. You register a client in the Zoho API Console to get a Client ID and Client Secret, then use OAuth to get access and refresh tokens. Older Zoho "authtoken" keys are no longer the way in.

What are the Zoho Inventory API rate limits?

100 requests per minute per organization, plus a daily total by plan: 1,000 on Free, 2,000 on Standard, 5,000 on Professional, and 10,000 on Premium and Enterprise. Going over returns HTTP 429.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.