Zoho One

Overview

The Zoho integration connects Bumblebee to three Zoho One products through a single OAuth authorization:

• Zoho CRM — leads, contacts, accounts, deals, and related sales records
• Zoho Billing — subscriptions, customers, plans, invoices, and payments (formerly Zoho Subscriptions)
• Zoho Desk — Helpdesk tickets, contacts, agents, departments, and knowledge-base articles

Each product is exposed as a single generic tool — a thin pass-through over the product's REST API. The agent supplies an HTTP method, a path, optional query parameters, and an optional JSON body, so every endpoint Zoho documents is reachable without a dedicated tool per operation.

Connecting your Zoho account

Bumblebee uses a hosted OAuth flow. There is nothing to create in Zoho's API console.

1. Go to the Integrations page in Bumblebee and open Zoho One.
2. Check the products you have and the access level you want for each:
   • CRM — Read-only or Read & write
   • Billing — Read-only or Read & write
   • Helpdesk — Read-only or Read & write
3. Click Connect with Zoho. You will be redirected to Zoho's consent screen, where you sign in and approve the requested permissions.
4. Zoho redirects you back to Bumblebee. The integration is now active.

The first time you connect, Bumblebee automatically discovers your Billing and Desk organization IDs and stores them with your credentials — no manual lookup needed.

Only check products you have provisioned in your Zoho account. Including a scope for a product you do not own (for example Desk on a CRM-only org) makes Zoho reject the whole authorization request.

Data centers

Bumblebee's OAuth app is registered as Multi-DC, so it works across every Zoho data center (US, EU, IN, AU, JP, CN, CA, SA). You don't need to pick a region — Zoho sends you to your region's sign-in screen automatically and reports it back to Bumblebee in the OAuth callback.

Reconnecting / revoking access

• Reconnect to change which products or access levels you authorize: open the Zoho integration page in Bumblebee and click Reconnect with Zoho.
• Revoke access at any time from Zoho Account Settings → Connected Apps.

Available tools

The integration exposes three generic HTTP tools. Each one is a thin wrapper over its product's REST API.

Zoho CRM (1 tool)

• zoho_crm_request - Make an arbitrary request to the Zoho CRM REST API (v8). Required: method (str), path (str). Optional: query_params (dict), body (dict), response_filter (str)
  • path is relative to /crm/v8, e.g. Contacts, Contacts/{id}, Deals/search, settings/modules
  • Write APIs expect records wrapped in a data array, e.g. {"data": [{"Last_Name": "Doe"}]}

Zoho Billing (1 tool)

• zoho_billing_request - Make an arbitrary request to the Zoho Billing REST API (v1). Required: method (str), path (str). Optional: query_params (dict), body (dict), response_filter (str)
  • path is relative to /billing/v1, e.g. subscriptions, subscriptions/{id}, customers, invoices, plans
  • The Billing organization ID is sent automatically as a header

Zoho Desk / Helpdesk (1 tool)

• zoho_desk_request - Make an arbitrary request to the Zoho Desk REST API (v1). Required: method (str), path (str). Optional: query_params (dict), body (dict), response_filter (str)
  • path is relative to /api/v1, e.g. tickets, tickets/{id}, tickets/{id}/comments, contacts, agents
  • The Desk organization ID is sent automatically as the orgId header

Notes

• Authentication: All three tools share one OAuth authorization. Bumblebee refreshes access tokens automatically from the stored refresh token, which does not expire.
• Response size: Large responses are capped automatically. Pass a response_filter (a JMESPath expression) to project only the fields you need.