Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
md 4.82 KB

How do I set up custom OAuth credentials for Zoho Inventory?

Use your own Zoho OAuth client when you want the consent screen to show your app name and to manage the client credentials yourself. You need access to an existing Zoho Inventory organization.

Create the Zoho OAuth client

  1. Sign in to the Zoho API Console with the account you use for Zoho Inventory. Use the console for your account's data center, for example https://api-console.zoho.in/ for India.
  2. Click Add Client (or Get Started for your first client) and choose Server-based Applications → Create Now. You can reuse an existing server-based client if it has the right redirect URI.

Zoho API Console client type picker with Server-based Applications

  1. Enter a Client Name and a Homepage URL. Use your own product name: Zoho rejects client names that contain ZOHO.
  2. In Authorized Redirect URIs, enter https://backend.composio.dev/api/v1/auth-apps/add. It must exactly match the auth config's oauth_redirect_uri field.

Zoho API Console Create New Client form with the Composio redirect URI

  1. Click Create, then open the Client Secret tab and copy the Client ID and Client Secret.

Zoho API Console Client Secret tab with the Client ID and Client Secret (redacted)

Create the auth config in Composio

  1. In the Composio dashboard, go to Auth Configs → Create and select Zoho Inventory.

  2. Choose OAuth 2.0 and Your Own Credentials, then paste the Client ID and Client Secret. Leave Redirect URI as the value you registered in Zoho.

  3. In Scopes, keep only what your workflow needs. To add a scope that isn't listed, type its exact name and click Add scope. Click Create Auth Config.

  4. Click Connect Account and enter your data center code in Region (see below). Organization ID is optional: enter it to pick a specific Inventory organization (find it under Settings → Organization Profile). If you leave it blank, Composio uses the first organization available to the account.

Composio Connect Account form with a data center code in Region and the optional Organization ID field

  1. Sign in to Zoho, review the app name, organization, and permissions, tick the consent checkbox if shown, and click Accept. Then open the auth config's Accounts tab and check that the account shows Active. The config showing Enabled doesn't mean an account is connected.

Zoho consent screen for Zoho Inventory with the consent checkbox and Accept button

Zoho Inventory auth config Accounts tab with the connected account Active

See custom auth configs for the general flow.

Scopes

Zoho takes scopes from the authorization request, so you set them in the auth config, not in the API Console. The default auth config requests the .ALL scopes for contacts, items, composite items, transfer orders, sales orders, packages, shipment orders, invoices, customer payments, credit notes, purchase orders, purchase receives, and bills, plus ZohoInventory.settings.READ. For a read-only check of organization details, ZohoInventory.settings.READ is enough. Check each tool against the Zoho Inventory API reference.

If you add scopes later, reconnect the account. An existing connection doesn't pick up new permissions.

Data center

Region is the ending of your Zoho Inventory web address: com for inventory.zoho.com, eu for inventory.zoho.eu, in for inventory.zoho.in, au for inventory.zoho.com.au. Other options are jp, ca, cn, and sa. Enter the code only, not a full URL. The client's data center and the account's data center must be compatible. If your app connects accounts in more than one data center, enable multi-DC support for those regions on the client in the API Console.

Troubleshooting

  • Redirect mismatch: compare the full callback URL in Zoho and in Composio, including the path.
  • Invalid client or data center error: check the API Console's data center, the account's data center, and Region.
  • Permission or organization error: check that the user can access the Zoho Inventory organization and that the auth config requests the scope the tool needs.