> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Let AI Agents Work Zoho CRM Leads and Deals

> Let agents search and manage Zoho CRM leads, contacts, accounts, deals, and tasks. Connect your own Zoho API client, and the gateway keeps tokens hidden.

## Overview

Buckle connects AI agents to [Zoho CRM](https://www.zoho.com/crm/) through OAuth. Agents can search records and read or manage leads, contacts, accounts, deals, and tasks. The gateway injects the token into every request, so your agent never sees it.

Zoho CRM uses **your own Zoho API client**. Setup takes about five minutes, once.

> [!NOTE]
>
> Buckle connects to Zoho's **US data center** (`zoho.com`). Accounts in other Zoho regions (EU, IN, AU, and others) aren't supported yet.

## What you will set up

* Your own Zoho API client (server-based application)
* A Zoho CRM connection on Zoho's US data center
* Per-agent, per-tool access to CRM records

## Connect Zoho CRM

**1. Create a Zoho API client**

Open the [Zoho API Console](https://api-console.zoho.com), click **Add Client**, and choose **Server-based Applications**. Name it `Buckle`.

**2. Add the redirect URI**

In Buckle, open **Settings** > **Apps** > **Zoho CRM** > **Custom credentials** and copy the **Redirect URI**. Paste it into the Zoho client's **Authorized Redirect URIs** and click **Create**.

![Zoho API Console Create New Client form with Server-based Applications selected, Client Name Buckle, Homepage URL https://buckle.example.com, and the Buckle redirect URI.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/zoho-crm/01-provider-create-client.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=a1ab86669e0b64c3d3ed20ad2a8368b4)

The Create New Client form in the Zoho API Console.

**3. Add your credentials and connect**

Copy the client's **Client ID** and **Client Secret** into **Custom credentials**, click **Save credentials**, then click **Connect Zoho CRM** and **Accept** in Zoho.

![Buckle connect window for Zoho CRM showing Configuration required, the setup guide link, and the Configure credentials button.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/zoho-crm/buckle-connect-zoho-crm.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=d0627de9ec721202d8cd44522a7ac9be)

The Zoho CRM connect window in Buckle before credentials are added.

## What agents can do

| Area | What agents can do |
| - | - |
| **Records** | List, read, create, update, and delete leads, contacts, accounts, deals, and tasks. Search across records |
| **Org** | List users, read settings, and read the organization |

## Controlling access

[Grant](/docs/guides/agent-access.md) the connection to each agent that needs it, and choose per tool what runs freely, what needs approval, and what's blocked. Put every **Delete** tool behind approval. Organization [rules](/docs/guides/rules.md) add guardrails on top. A blocked request never reaches Zoho.

To disconnect, remove the connection in **Settings** > **Apps** > **Zoho CRM**, then delete the client in the Zoho API Console.

## FAQ

> [accordion] Which Zoho regions are supported?
>
> Only Zoho's US data center (`zoho.com`). EU, IN, AU, and other regions aren't supported yet.

> [accordion] Does the agent see my Zoho token?
>
> No. The token stays in Buckle, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] Can I stop agents from deleting records?
>
> Yes. Block or require approval for delete tools when you [grant](/docs/guides/agent-access.md) the connection.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.