> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Zoho CRM connector

- Connector: `appmixer.zoho.crm`
- Version: 2.4.5
- Components: 32 (9 triggers, 23 actions)

An Intuitive CRM to Better Tack & Manage Leads, and Close Deals Faster. Try For Free. The Best Way to Manage Your Sales Pipeline. Get Started in Less Than 2 Minutes!

- Connector page: <https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/zoho/crm>
- Download package: <https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/download>

## Authentication

**Type:** OAuth 2

This connector is globally authenticated and verified by Appmixer (Authentication Hub) and is ready to use without registering your own OAuth application with the provider. You can still use your own OAuth credentials (clientId and clientSecret) - see the Connector Configuration section of the documentation. The Authentication Hub is enabled for all hosted Appmixer tenants; on self-managed installations it has to be explicitly set.

**Auth URL:** <https://accounts.zoho.com/oauth/v2/auth?access_type=offline&prompt=consent>

**Scopes:**

- `ZohoCRM.modules.ALL`
- `ZohoCRM.users.ALL`
- `ZohoCRM.settings.fields.READ`
- `ZohoCRM.notifications.ALL`

## Triggers (9)

- [Appointment Started](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.AppointmentStarted.md) (`appmixer.zoho.crm.AppointmentStarted`): Fires when an appointment's start time is reached in Zoho CRM.
- [Case Closed](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CaseClosed.md) (`appmixer.zoho.crm.CaseClosed`): Fires when a case moves into the status your organization uses for closed cases.
- [Case Updated](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CaseUpdated.md) (`appmixer.zoho.crm.CaseUpdated`): Fires every time a case is updated in Zoho CRM.
- [Invoice Due Date](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.InvoiceDueDate.md) (`appmixer.zoho.crm.InvoiceDueDate`): Fires when an invoice reaches its due date, or a configurable number of days before it.
- [Invoice Overdue](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.InvoiceOverdue.md) (`appmixer.zoho.crm.InvoiceOverdue`): Fires when an invoice's due date has passed without the invoice leaving the excluded status.
- [Lead Created](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.LeadCreated.md) (`appmixer.zoho.crm.LeadCreated`): This trigger fires every time a new lead is created.
- [Lead Updated](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.LeadUpdated.md) (`appmixer.zoho.crm.LeadUpdated`): This trigger fires every time a lead is updated.
- [Contact Created](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.ContactCreated.md) (`appmixer.zoho.crm.ContactCreated`): This trigger fires every time a new contact is created.
- [Contact Updated](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.ContactUpdated.md) (`appmixer.zoho.crm.ContactUpdated`): This trigger fires every time a contact is updated.

## Actions (23)

- [Accept Quote](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.AcceptQuote.md) (`appmixer.zoho.crm.AcceptQuote`): Marks a quote as accepted by moving it to the quote stage your organization uses for accepted quotes.
- [Accept / Decline Appointment](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.AcceptDeclineAppointment.md) (`appmixer.zoho.crm.AcceptDeclineAppointment`): Accepts or declines an existing appointment in Zoho CRM. Accepting keeps the appointment scheduled; declining cancels it with an optional reason.
- [Create Appointment](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CreateAppointment.md) (`appmixer.zoho.crm.CreateAppointment`): Schedules an appointment in Zoho CRM for a contact, a service and a service member. Requires the Services module to be enabled in the Zoho CRM organization.
- [Create Contact](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CreateContact.md) (`appmixer.zoho.crm.CreateContact`): This component creates a new contact.
- [Create Contact Attachment](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CreateContactAttachment.md) (`appmixer.zoho.crm.CreateContactAttachment`): Attaches a file to a Zoho CRM contact - either an uploaded file or a link to a file.
- [Create Custom Module](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CreateCustomModule.md) (`appmixer.zoho.crm.CreateCustomModule`): Creates a custom module in Zoho CRM. Custom modules are available in paid Zoho CRM editions only. Additional scopes: `ZohoCRM.settings.modules.ALL`, `ZohoCRM.settings.modules.READ`, `ZohoCRM.settings.profiles.READ`.
- [Create Lead](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CreateLead.md) (`appmixer.zoho.crm.CreateLead`): This component creates a new lead.
- [Create Note](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.CreateNote.md) (`appmixer.zoho.crm.CreateNote`): Creates a note attached to an existing record in Zoho CRM.
- [Decline Quote](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.DeclineQuote.md) (`appmixer.zoho.crm.DeclineQuote`): Marks a quote as declined by moving it to the quote stage your organization uses for rejected quotes.
- [Delete Contact](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.DeleteContact.md) (`appmixer.zoho.crm.DeleteContact`): This component deletes existing contact.
- [Delete Lead](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.DeleteLead.md) (`appmixer.zoho.crm.DeleteLead`): This component deletes existing lead.
- [Find Appointments](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.FindAppointments.md) (`appmixer.zoho.crm.FindAppointments`): Finds Zoho CRM appointments that match the given search criteria — appointment name, status or start time range.
- [Find Contact](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.FindContact.md) (`appmixer.zoho.crm.FindContact`): This action finds contact by email address.
- [Find Custom Modules](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.FindCustomModules.md) (`appmixer.zoho.crm.FindCustomModules`): Finds the custom modules of the Zoho CRM organization. Without a query it returns all of them. Additional scopes: `ZohoCRM.settings.modules.READ`.
- [Find Invoices](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.FindInvoices.md) (`appmixer.zoho.crm.FindInvoices`): Finds Zoho CRM invoices, optionally restricted by invoice date range, due date range or status.
- [Find Lead](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.FindLead.md) (`appmixer.zoho.crm.FindLead`): This action finds lead.
- [Get Case](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.GetCase.md) (`appmixer.zoho.crm.GetCase`): Pulls all information on a single case (support ticket) in Zoho CRM.
- [Get Custom Module](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.GetCustomModule.md) (`appmixer.zoho.crm.GetCustomModule`): Gets the metadata of a Zoho CRM module by its API name - labels, status and what the API allows to do with its records. Works for any module, custom or standard. Additional scopes: `ZohoCRM.settings.modules.READ`.
- [Get Quote](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.GetQuote.md) (`appmixer.zoho.crm.GetQuote`): Pulls all details of a single quote in Zoho CRM.
- [List Records](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.ListRecords.md) (`appmixer.zoho.crm.ListRecords`): When triggered, returns a list of records for specified module.
- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.MakeApiCall.md) (`appmixer.zoho.crm.MakeApiCall`): Performs an arbitrary authorized API call to the Zoho API.
- [Update Contact](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.UpdateContact.md) (`appmixer.zoho.crm.UpdateContact`): This component updates existing contact.
- [Update Lead](https://connectors.appmixer.com/connector/appmixer.zoho.crm/2.4.5/component/appmixer.zoho.crm.UpdateLead.md) (`appmixer.zoho.crm.UpdateLead`): This component updates existing lead.

## Changelog

### 2.4.5

- Security: upgraded form-data to 4.0.6 (predictable multipart boundary, CRLF injection in field names and filenames).

### 2.4.4

- Security: upgraded moment to 2.31.0 (medium advisory).

### 2.4.3

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 2.4.2

- Clearer error when a module cannot be used. Zoho answers with a bare "the module name given seems to be invalid" (INVALID_MODULE) or "permission denied to access the module" (NO_PERMISSION); the error now also shows the request and the usual reasons: the module is not in the edition of the connected Zoho CRM organization or is disabled, the name is not a module API name, or the profile of the connected user has no permission for it.

### 2.4.1

- Accounts in the Canada, Japan, Saudi Arabia, United Kingdom, United Arab Emirates and Singapore data centers can be connected. Connecting a Canada account used to fail with "Invalid access token": the region was not recognized, so the authorization code was exchanged at accounts.zoho.com and the API was called at www.zohoapis.com. The connector now uses the accounts server Zoho names in the redirect callback and the API host from the token response (`api_domain`), both checked against the known Zoho data centers. Existing accounts keep working without reconnecting.
- An unknown data center region is reported instead of silently falling back to the US data center.
- MakeApiCall calls the API host of the account's data center (it used its own region list, without Canada, Japan, Saudi Arabia, the United Kingdom, the United Arab Emirates and Singapore).
- Connecting an account through the Auth Hub no longer fails with "Missing region: undefined." The data center is found by asking Zoho - the code exchange and the profile request try the data centers until one accepts the authorization code or the access token - instead of being remembered from the redirect callback, which in the Auth Hub runs as a separate request, possibly in another process. Token refresh through the Auth Hub, which does not know the account's data center either, finds it the same way.

### 2.4.0

- Added CreateAppointment action for scheduling an appointment (requires the Services module).
- Added CreateContactAttachment action for attaching an uploaded file or a link to a contact.
- Added FindCustomModules, GetCustomModule and CreateCustomModule actions. They ask for the additional ZohoCRM.settings.modules and ZohoCRM.settings.profiles.READ permissions only when they are used; accounts used with the other components are not affected.
- Fixed intermittent "Parse Error: Expected HTTP/" (HPE_INVALID_CONSTANT) failures in components that read from Zoho. Every GET request was sent with an empty JSON body ({}), which Zoho does not read; on a reused connection those stray bytes corrupted the next response. GET and HEAD requests are now sent without a body.
- A refused OAuth token request is reported instead of being stored. Zoho answers with HTTP 200 and an `error` in the body, so a failed token refresh used to leave the account holding an empty access token: it kept looking connected and every later call failed with an unrelated "Access token not found". An account without a refresh token now says so as well.
- CreateCustomModule also asks for the module read permission, which it needs to read the created module back. One connected account then covers all three custom module components: an account is matched to a component by the exact permission strings it was granted, so an account holding only the write permission was refused by Find/Get Custom Module.

### 2.3.0

- Added GetCase, GetQuote, FindAppointments and FindInvoices actions.
- Added AcceptQuote, DeclineQuote, AcceptDeclineAppointment and CreateNote actions.
- Added AppointmentStarted, CaseUpdated, CaseClosed, InvoiceDueDate and InvoiceOverdue triggers.
- ListFields: the field cache is scoped to the connected Zoho user, so one organization's picklist values are no longer offered to another.
- Connecting an account always asks for consent, so Zoho issues a refresh token also when the same Zoho user reconnects (such accounts used to stop working after an hour).

### 2.2.0

- Added MakeApiCall component for performing arbitrary authorized API calls to the Zoho API.

### 2.1.0

- Added test() (Flow Test Mode) to the ContactCreated, ContactUpdated, LeadCreated and LeadUpdated triggers.

### 2.0.3

- Fixed module ID.

### 2.0.2

- Fixed outports for ListAccounts, ListContacts and ListLeads.

### 2.0.1

- Fixed creating EU endpoint URLs.

### 2.0.0

- Switch to ZOHO V2 (apiKey to Oauth).

### 1.0.0

- Initial version
