# Zoho Bigin for AI agents. Make the right deal easier to review.

> Read accessible deals and related records in Zoho Bigin. Prepare a source-grounded pipeline briefing within the selected account.

- Page: https://www.agent200.com/connectors/zoho-bigin/
- Category: CRM and sales
- Authentication: Managed OAuth
- Identifier in code: `zoho_bigin`
- Create an API key: https://agent200.com/platform/apikeys/
- Updated: 2026-11-18

## Instructions for AI agents

Connector: Zoho Bigin, through Agent200. In code: "zoho_bigin".
What it does: Read accessible deals and related records in Zoho Bigin. Prepare a source-grounded pipeline briefing within the selected account.
Page: https://www.agent200.com/connectors/zoho-bigin/

1. Get an Agent200 API key. If the developer has none, send them to https://agent200.com/platform/apikeys/ and ask them to choose "Create an API key". Read the key from the AGENT200_API_KEY environment variable. Never ask for it in chat, and never write it into code, prompts or logs.
2. Sign-in is managed OAuth. Each end user approves access once, on Zoho Bigin's own page, through the authorization link Agent200 returns. Never ask a user for a Zoho Bigin password or token in chat.
3. Give every request a stable id for the end user. Agent200 uses only that user's own connection.
4. Read tools: zoho_bigin_list_contacts, zoho_bigin_get_contact, zoho_bigin_list_deals, zoho_bigin_get_deal, zoho_bigin_list_companies. Name "zoho_bigin" in the tools of a request; the model decides which tool to call.
5. Stay within the project's settings. If a tool is turned off or a call is refused, tell the user. Do not work around it.
6. Before a write, confirm with the user, unless they asked for that exact change.
7. For setup with a specific framework, follow its guide:
   https://www.agent200.com/connectors/zoho-bigin/framework/claude/
   https://www.agent200.com/connectors/zoho-bigin/framework/chatgpt/
   https://www.agent200.com/connectors/zoho-bigin/framework/claude-code/
   https://www.agent200.com/connectors/zoho-bigin/framework/muse/
   https://www.agent200.com/connectors/zoho-bigin/framework/grok-bot/
   https://www.agent200.com/connectors/zoho-bigin/framework/openai-dots/
   https://www.agent200.com/connectors/zoho-bigin/framework/claude-duet/
   https://www.agent200.com/connectors/zoho-bigin/framework/hermes-agent/
   https://www.agent200.com/connectors/zoho-bigin/framework/openclaw/

The code on the connector page is a conceptual example of the SDK. SDK reference: https://docs.igpt.ai/

## About

With the Zoho Bigin connector, your agent reads contacts, companies and deals in each user's own Zoho Bigin account. It can list and read contacts, list companies, and list and read deals, using only the tools your project allows.

Zoho Bigin is a simple CRM for small businesses.

## Zoho Bigin tools

- **List contacts** (`zoho_bigin_list_contacts`, read): Find contacts in the authorized Bigin organization.
- **Read a contact** (`zoho_bigin_get_contact`, read): Retrieve one contact by its record ID.
- **List deals** (`zoho_bigin_list_deals`, read): Find deals in an accessible pipeline.
- **Read a deal** (`zoho_bigin_get_deal`, read): Retrieve one identified deal and its returned stage.
- **List companies** (`zoho_bigin_list_companies`, read): Find associated company records.

## Limits you can set

**Turn single tools on or off.** Let the agent read contacts and deals, and switch off `zoho_bigin_get_deal` if it should only see lists of deals.

**Restrict what the agent reaches.** Choose the endpoints and scopes a project may use, for example contacts and companies but not deals. A call outside them is refused.

## Get started

### Step 1: Set up the SDK

Add the Agent200 SDK to the codebase you already have and authenticate with your API key. The key covers every connector enabled for the project.

File `agent.js`:

```js
// One Agent200 API key covers every connector enabled for the project.
const agent200 = new Agent200({
  apiKey: process.env.AGENT200_API_KEY,
});
```

(Conceptual example of the Agent200 SDK.)

### Step 2: Let your user connect Zoho Bigin

Each end user authorizes their own Zoho Bigin account once. Agent200 runs the OAuth flow, handles the callback, stores the tokens and refreshes them.

File `connect.js`:

```js
// Each end user authorizes their own Zoho Bigin account, once.
const connection = await agent200
  .user("user_123")
  .connect("zoho_bigin");

if (connection.authorizationUrl) {
  // Show this link to your user; Agent200 handles the rest.
  console.log(connection.authorizationUrl);
}
```

(Conceptual example of the Agent200 SDK.)

### Step 3: Run with the Zoho Bigin tools

Name the user, the model and the tools. The model decides which Zoho Bigin tools to call, and Agent200 executes them with that user's connection.

File `run.js`:

```js
const result = await agent200
  .user("user_123")
  .run({
    model: "openai/gpt-5.6-sol",
    input: "List the open deals in my pipeline",
    tools: ["zoho_bigin"],
  });

console.log(result.output);
```

(Conceptual example of the Agent200 SDK.)

## Sign-in and permissions

**Connect the intended account.** Use the documented Zoho Bigin authorization route. Confirm the organization, team or workspace before reading records.

**Match access to the request.** Authorize the intended Zoho organization and the read scopes for Bigin records. Use the module API names and record IDs returned by that organization.

**Preserve the application user.** Keep the same stable application user identity for connection and later requests. Store the Agent200 key outside prompts and code.

## Example requests

- "List the open deals in my pipeline"
- "Show the contact details for Dana Lee"
- "Which companies do we have in Zoho Bigin"

## Guides: Zoho Bigin with your AI framework

- [Zoho Bigin + Claude](https://www.agent200.com/connectors/zoho-bigin/framework/claude.md): Read deals with Claude and Agent200. Prepare a pipeline briefing using the connected user’s own Zoho Bigin account.
- [Zoho Bigin + ChatGPT](https://www.agent200.com/connectors/zoho-bigin/framework/chatgpt.md): Use ChatGPT to build a separate read-only Zoho Bigin assistant with Agent200. Ground the pipeline briefing in returned source data.
- [Zoho Bigin + Claude Code](https://www.agent200.com/connectors/zoho-bigin/framework/claude-code.md): Use Claude Code to build a separate read-only Zoho Bigin assistant with Agent200. Ground the pipeline briefing in returned source data.
- [Zoho Bigin + Muse](https://www.agent200.com/connectors/zoho-bigin/framework/muse.md): Read deals with Muse and Agent200. Prepare a pipeline briefing using the connected user’s own Zoho Bigin account.
- [Zoho Bigin + Grok Bot](https://www.agent200.com/connectors/zoho-bigin/framework/grok-bot.md): Read deals with Grok Bot and Agent200. Prepare a pipeline briefing using the connected user’s own Zoho Bigin account.
- [Zoho Bigin + OpenAI Dots](https://www.agent200.com/connectors/zoho-bigin/framework/openai-dots.md): Use OpenAI Dots to build a separate read-only Zoho Bigin assistant with Agent200. Ground the pipeline briefing in returned source data.
- [Zoho Bigin + Claude Duet](https://www.agent200.com/connectors/zoho-bigin/framework/claude-duet.md): Read deals with Claude Duet and Agent200. Prepare a pipeline briefing using the connected user’s own Zoho Bigin account.
- [Zoho Bigin + Hermes Agent](https://www.agent200.com/connectors/zoho-bigin/framework/hermes-agent.md): Read deals with Hermes Agent and Agent200. Prepare a pipeline briefing using the connected user’s own Zoho Bigin account.
- [Zoho Bigin + OpenClaw](https://www.agent200.com/connectors/zoho-bigin/framework/openclaw.md): Read deals with OpenClaw and Agent200. Prepare a pipeline briefing using the connected user’s own Zoho Bigin account.

## FAQ

### What access does Zoho Bigin need?

Authorize the intended Zoho organization and the read scopes for Bigin records. Use the module API names and record IDs returned by that organization. [Provider documentation](https://www.bigin.com/developer/docs/apis/v2/get-records.html).

### Does a list include every record?

Bigin modules can be renamed and fields customized. Check the organization and module before interpreting a stage.

### Can this workflow make changes?

The listed Zoho Bigin operations are read-only. A proposed change in the agent answer does not edit the source.

### How should I verify the answer?

Identify the selected deal and compare the answer with deal stage, contact and company fields. Disclose missing or inaccessible fields.

### Are these exact runtime tool schemas?

The listed identifiers describe catalogue capabilities. Discover the actual runtime tool names and input schemas before executing a request.

## Related connectors

- [HubSpot](https://www.agent200.com/connectors/hubspot.md): Look up and update contacts, companies and deals in your users' HubSpot CRM.
- [Salesforce](https://www.agent200.com/connectors/salesforce.md): Query and update accounts, contacts and opportunities in Salesforce.
- [LinkedIn](https://www.agent200.com/connectors/linkedin.md): Share posts and read profile details on LinkedIn on behalf of each of your users, where the relevant API permissions are available.
- [Zendesk](https://www.agent200.com/connectors/zendesk.md): Search, read, create and update Zendesk tickets, and reply to customers, on behalf of each of your users.

---

Agent200: https://www.agent200.com/ · API keys: https://agent200.com/platform/apikeys/ · Docs: https://docs.igpt.ai/
