Overview

Zoho CRM is a customer relationship management (CRM) platform used to manage leads, contacts, accounts, deals, and sales pipelines. Persona’s integration with Zoho CRM helps teams keep identity and risk context aligned with the customer records your go-to-market, support, and operations teams already use.

This integration reduces manual work by allowing Persona Workflows to read from and write to Zoho CRM module records (including standard and custom modules), so you can automate record enrichment and downstream processes without switching tools.

Benefits

Faster Record Enrichment: Automatically write Persona outcomes and key attributes back to Zoho CRM records—keeping your CRM up to date without manual copy-paste.

More Consistent Operations: Standardize how identity context is recorded across Leads/Contacts/Accounts (and custom modules), improving reporting and handoffs between teams.

Scalable Automation: Create or update records in bulk (within Zoho limits) to support high-volume onboarding and operational workflows.

Integration Features

Persona’s Zoho CRM integration helps you connect Persona to your CRM system of record. Key capabilities include:

• List Records: Pull lists of records from a module with configurable field selection and pagination so workflows can reference the right CRM objects.
• Get Record: Retrieve a single record when you need full details (for example, when subforms or multi-select lookup values are required).
• Create Records: Create new module records and optionally run supported Zoho automations during record creation.
• Upsert Records: Insert or update records based on Zoho’s duplicate-check behavior, helping you keep CRM data in sync without creating duplicates.

Setting up the Zoho CRM integration

Prerequisites

To set up the Zoho CRM integration, ensure you have:

• Admin access to your Zoho CRM account
• Necessary API permissions to access Zoho CRM credentials

Setting up the Zoho CRM Credentials

1. In the Persona Dashboard, navigate to Integrations > Marketplace and click on Zoho CRM.
2. Click on Add Credential at the top of the page.
3. Enter a credential nickname and click Continue.
4. When prompted, select the Zoho Accounts domain that matches the data center where your Zoho account is hosted (for example, US, EU, IN, AU, JP, CA, SA, or CN).
5. Log in to Zoho in the popup window and approve access when prompted.

Note: If you select the wrong data center/domain, your credential may not work as expected. Confirm which Zoho domain your organization uses before connecting.

Using the Zoho CRM integration in a workflow

1. Create a new workflow, or open an existing workflow you’d like to update.
2. Add a new Action step > Integrations.
3. Select the Zoho CRM integration and choose your saved Zoho CRM credential.
4. Select the operation you want to run (for example, list records, create records, or upsert records) and map Persona data into the Zoho CRM fields.
5. Save and publish the workflow.

Zoho CRM Operations Overview

In addition to syncing field values, Persona can create records, update records, and retrieve records using Zoho CRM’s API. These actions support seamless two-way workflows, letting teams manage investigations without switching platforms. See below for a comprehensive list of available Workflow Action steps and possible configurations for the Zoho CRM integration:

List Records

Use this action to fetch a paginated list of records from a Zoho CRM module so your workflow can reference existing CRM data (for example, finding the right Lead, Contact, or custom-module record before taking action). This is especially helpful when you want to enrich a Persona Case with CRM context or drive conditional logic based on CRM attributes.

Zoho supports paging through results with standard page-based pagination up to a limit, and then using page tokens for deeper pagination as needed. Page tokens expire after a limited time, so they’re best used in immediate follow-up steps rather than stored for later.

Configuration Steps:

• Provide values for required fields:
  • Module API Name (for example, Leads, Accounts, Contacts, Deals, or other supported modules)
  • Fields (up to 50 field API names per request)
• Optionally add:
  • Page size (up to 200 records per request)
  • Page number (useful for up to 2,000 records)
  • Page token (for retrieving more than 2,000 records; valid for 24 hours)
  • Sorting options and saved-view filtering (for example, using a custom view)
  • Territory filtering (including whether to include child territories)

Get Record

Use this action to retrieve a specific Zoho CRM record when you already know which record you need (for example, after selecting an ID from a prior step). This is a good option when your workflow needs the most complete view of a record, since certain field types (like subforms and multi-select lookup fields) are only returned when fetching a specific record.

Configuration Steps:

• Provide values for required fields:
  • Module API Name
  • Record ID
• Optionally add:
  • Fields (if you want to limit which fields are returned, rather than retrieving a broader record payload)

Create Records

Use this action to create new records in Zoho CRM modules (including standard modules like Leads or Contacts) based on Persona events—such as inquiry completion, a risk signal, or a case status change. This supports workflows like creating a new Lead when an applicant enters your funnel, or creating a custom-module record to track onboarding milestones.

Zoho allows inserting records in batches (up to 100 at a time), and you can optionally request that Zoho run supported automations during record creation (such as workflow, approval, blueprint, and others). If your Zoho setup relies on assignment rules, you can also trigger an assignment rule using its ID.

Configuration Steps:

• Provide values for required fields:
  • Module API Name
  • Records (one or more records with Zoho field API names and values; up to 100 per call)
• Optionally add:
  • Trigger (which Zoho automations to execute)
  • Assignment rule ID (to route ownership via Zoho assignment rules)
  • Feature execution settings (for example, applying layout rules / validation rules, or skipping Cadences)

Upsert Records

Use this action when you want Persona to either create a new record or update an existing one—without having to decide which one in advance. Upsert is commonly used to keep Zoho CRM updated over time (for example, updating a Contact with the latest Persona outcome), while avoiding duplicates by matching on Zoho’s duplicate-check behavior.

Zoho supports upserting up to 100 records per call, and it can run certain automations during the upsert as well. This makes it useful for high-volume workflows where you want data consistency and automation together.

Configuration Steps:

• Provide values for required fields:
  • Module API Name
  • Records (up to 100 per call)
• Optionally add:
  • Duplicate-check fields (to control how Zoho matches existing records)
  • Trigger (which Zoho automations to execute during upsert)
  • Feature execution settings (for example, applying layout rules / validation rules, or skipping Cadences)

FAQs

Which Zoho data centers are supported when connecting credentials?

Zoho uses different domains by data center, and you should choose the domain that matches where your organization’s Zoho account is hosted (for example, US, EU, IN, AU, JP, CA, SA, and CN).

Do I have to choose fields when listing records?

Yes—Zoho’s “get records” behavior requires specifying which fields you want returned, and you can include up to 50 field API names in a single request.

Can I create or upsert multiple records in one workflow step?

Yes—Zoho supports creating and upserting records in batches of up to 100 records per request.