# Zoho CRM for Docusign IAM

> Eliminate manual data entry between your CRM and document workflows. Read contact and deal data from Zoho CRM to pre-fill envelopes, write signed data back, and attach completed documents — all without leaving your workflow.

- Web page: https://fluidlabs.com/documentation/zoho-for-docusign
- Published by: Fluidlabs
- Status: Live on the Docusign App Center
- Docusign App Center listing: https://apps.docusign.com/app-center/app/0b5d5199-c7a4-4664-9e99-f597bceff9a4
- App page: https://fluidlabs.com/integrations/zoho-for-docusign
- Last updated: 2026-06-04
- Support: docusign-support@fluidlabs.com

## Contents

- [Quick Start](https://fluidlabs.com/documentation/zoho-for-docusign#quick-start)
- [Implementation Guide & Known Behaviors](https://fluidlabs.com/documentation/zoho-for-docusign#implementation-guide--known-behaviors)
- [Installation and Configuration](https://fluidlabs.com/documentation/zoho-for-docusign#installation-and-configuration)
- [How to use App](https://fluidlabs.com/documentation/zoho-for-docusign#how-to-use-app)
- [Read from Zoho CRM](https://fluidlabs.com/documentation/zoho-for-docusign#read-from-zoho-crm)
- [Writeback to Zoho CRM](https://fluidlabs.com/documentation/zoho-for-docusign#writeback-to-zoho-crm)
- [File Upload Zoho CRM](https://fluidlabs.com/documentation/zoho-for-docusign#file-upload-zoho-crm)
- [FAQ & Troubleshooting](https://fluidlabs.com/documentation/zoho-for-docusign#faq--troubleshooting)

---

## Quick Start 

### Quick Start  

#### 1. Installation

* Open the Docusign App Center and search for **Zoho CRM**.
* Click **Install App** and grant the required permissions.
* After installing, click [**Connect Account**](https://fluidlabs.com/documentation/zoho-for-docusign#installation-and-configuration) to link your Zoho CRM organization.

#### 2. Creating a Connection

* Choose the connection type:

  * **Shared** - accessible by the whole team (recommended).
  * **Private** - accessible only by you.

* Give your connection a clear name (e.g., "Zoho CRM - Demo").

* Select your Zoho CRM organization and click **Submit**, then review the permissions and click **Accept**.

#### 3. Creating a Workflow

* Navigate to **Agreements → Workflows**.
* Click **Create Workflow** to start building.
* Set the workflow start to **From an API Call**, create an `object_id` variable (Type: Text), and select **Automated process**.

#### 4. Available Actions

The app provides three actions to use inside your workflow:

* [**Read from Zoho CRM**](https://fluidlabs.com/documentation/zoho-for-docusign#read-from-zoho-crm) - retrieve data from a Zoho CRM record (Contacts, Accounts, Leads, Deals, or Vendors).
* [**Writeback to Zoho CRM**](https://fluidlabs.com/documentation/zoho-for-docusign#writeback-to-zoho-crm) - update existing records or create new ones in Zoho CRM.
* [**File Upload Zoho CRM**](https://fluidlabs.com/documentation/zoho-for-docusign#file-upload-zoho-crm) - attach a signed document to a specific Zoho CRM record.

#### 5. Key Things to Know

* **File Upload:** In the Select drive dropdown, choose the module that matches your workflow (e.g., Contacts). Use **New Subfolder → Add Variable** and select the record ID from the Read step to dynamically attach files to the correct record.
* **Writeback:** Each module has mandatory fields marked with a red asterisk. Always map them, as they are required for the step to work correctly.
* **Lookup fields:** Never map both the Name and the ID for the same relationship field simultaneously — the operation will fail. See the [**Implementation Guide & Known Behaviors**](https://fluidlabs.com/documentation/zoho-for-docusign#implementation-guide--known-behaviors) for details.


## Implementation Guide & Known Behaviors

### Owner Assignment (User Mapping)

* Reassigning record owners (e.g., `Contact Owner`, `Lead Owner`, `Vendor Owner`, `Account Owner`) is done via exact text name mapping (e.g., passing the string `"Manager One"`).
* The string must match the Zoho CRM user's name exactly. If there are multiple active users in the Zoho CRM environment with the exact same name, the connector will fail to prevent assigning the record to the wrong user.

### Working with Lookup Fields 

(e.g., `Account`, `Reporting To`, `Parent Account`)

* You can link relational records using either the exact text name (e.g., `Account Name` = "Widget Corp") OR the system ID (e.g., `Account ID` = "8967800...").
* Do **not** map both the Name and the ID for the same entity simultaneously. If both fields are populated in the workflow, the operation will fail. Choose one method per relationship.
* When mapping via Name, if the Zoho CRM database contains multiple records with identical names (e.g., two separate branches of "Widget Corp"), the connector will intentionally fail. This is a safety mechanism to prevent linking data to the incorrect record. In such cases, use the `ID` field instead.
* In the Contacts module, if you are mapping both an `Account` and a `Reporting To` manager, the manager specified in `Reporting To` must be associated with the exact same `Account` in Zoho CRM. Attempting to assign a manager who belongs to a different company (or no company) will result in an API error.

### Data Formatting and Validation

* Zoho CRM enforces strict formatting rules on specialized fields (e.g., the `Twitter` field will reject any string containing a space or special sumbols; currency and number fields will reject any alphabetic characters).
* Currently, if Zoho rejects a request due to invalid data formats (a 400 Bad Request), the Workflow Builder connector may display a generic technical error (e.g., `AxiosError`) instead of the specific validation message. If a workflow fails during a Writeback step, always double-check the formatting and data types of the values being passed to specialized fields.

### Mandatory Fields in Writeback

Each Zoho CRM module has required fields that must be mapped in the Writeback step. These fields are marked with a red asterisk (✱) in the UI. Without them, the step will not save and the workflow will not run correctly.

The mandatory fields per module are:

* **Contacts** - `Last Name`
* **Leads** - `Last Name`, `Company`
* **Accounts** - `Account Name`
* **Deals** - `Deal Name`, `Account Name`, `Stage`, `Closing Date`
* **Vendors** -` Vendor Name`

> ⚠️ These fields are also used by the connector to identify whether to update an existing record or create a new one. Make sure the value passed to the mandatory field is accurate and consistent with your Zoho CRM data.

### Lookup Fields by Module

The table below lists the available lookup fields for each module. Refer to section 2 for the general rules on how to map them correctly.

#### Contacts

* `Account` - link to an Account record via `Account Name` or `Account ID`
* `Reporting To` - link to another Contact (manager) via name or ID. Must belong to the same Account.

#### Leads

* _None_ – Unlike other modules, Leads do not use lookup fields to link to existing Accounts or Contacts during creation. 
  Note: The `Company` field is a standard text string, not a relational lookup. You do not need an Account ID to fill it.

#### Accounts

* `Parent Account` - link to a parent Account record via `Account Name` or Account ID

#### Deals

* `Account` - link to an Account record via `Account Name`
* `Contact` - link to a Contact record via `Contact Name` or `Contact ID`
* `Campaign Source` - link to a Campaign record via `Campaign Source Name` or `Campaign Source ID`

> ⚠️ For each of the above relationships, map **either** the Name **or** the ID — never both. Mapping both fields for the same entity may cause workflow failures or unpredictable payload overrides.

#### Vendors

* `Vendor Name` - link to a Vendor record via `Vendor Name`

### Update Operations – "Overwrite if field value exists" Checkbox

* When configuring an Update (Writeback) operation, Workflow Builder provides an **"Overwrite if field value exists"** checkbox per mapped field.
* If the checkbox is **unchecked**, Workflow Builder will only populate fields that are currently **blank** in Zoho — existing values will not be touched.
* If the checkbox is **checked**, Workflow Builder will overwrite the existing value with the new one from the workflow.

> 💡 **Rule of thumb:** Always check this box if your workflow is intended to explicitly change existing values — including names, numbers, or linked lookups (e.g., changing the `Account Name` linked to a Deal).


## Installation and Configuration

### Installation and Configuration

This section explains how to install and configure the Zoho CRM integration for use with Docusign Workflow Builder.

### Prerequisites

Before starting, ensure that:

* You are logged in to a Zoho CRM account with the required permissions.
* You are logged in to a Docusign account with Admin rights to install and manage applications.

### How to Install the App

1. Open the **Docusign App Center**.
2. Search for **Zoho CRM** in the search bar.
   * ![Docusign App Center search results for 'zoho' showing the Zoho CRM app by Fluidlabs.](https://fluidlabs.com/images/documentation/zoho-for-docusign/6c730d8ed7027e643c48cf79f8552dff.webp)
     _\[App Center search results showing the Zoho CRM app by Fluidlabs]_
3. Click the **Zoho CRM** app card to open its detail page.
4. Click the **Install App** button to begin.
   * ![The Zoho CRM app page in the Docusign App Center, by Fluidlabs, with the Install App button.](https://fluidlabs.com/images/documentation/zoho-for-docusign/061fbfdec9a6112c15aae2886b10fd52.webp)
     _\[Zoho CRM app page with the Install App button in the top right corner]_

### Connecting Your Account

Once the app is installed, you need to authorize the connection between Docusign and Zoho CRM.

1. **Initiate Connection:** After installation, the app page will show an **Installed** status. Click the **Connect Account** button to begin linking your Zoho CRM account.
   * ![Zoho-CRM integration page displaying a 'Connect Account' button and visual of record management.](https://fluidlabs.com/images/documentation/zoho-for-docusign/1b9a2424a5c4c16d19db085a6866ea74.webp)
     _\[App page showing "Installed" badge and the Connect Account button]_

2. **Select Account Type:** You will be prompted to choose the connection visibility:

   * **Private:** The connection is accessible only by you in Docusign.
   * **Shared (Recommended):** The connection is accessible by multiple users or the whole team in Docusign. Best for collaborative workflows.
   * ![Zoho CRM account connection screen with private and shared access options.](https://fluidlabs.com/images/documentation/zoho-for-docusign/522e3f41fe50084bc82ce7f9aad70c9e.webp)
     _\[Select Account Type screen showing Private and Shared options]_

3. **Name the Connection:** Enter a clear name for your connection (e.g., "Zoho CRM - Demo"). This name will appear in Workflow steps, so make it easily identifiable.
   * ![User interface showing the process of naming a Zoho CRM account connection in an input field.](https://fluidlabs.com/images/documentation/zoho-for-docusign/58332f776cf3f82d9b0a5f61e1b502c8.webp)
     _\[Name Connection screen with "Zoho CRM - Demo" entered in the field]_

4. **Authorize with Zoho CRM:** You will be redirected to the Zoho authorization screen. The process has two steps:

5. **Step 4a — Select Organization:**

6. A dialog will appear asking you to choose which Zoho CRM organization to connect. Select your organization from the list and click **Submit**.
   * ![Docusign Production screen showing an SSO selection pop-up for Microsoft AADB.](https://fluidlabs.com/images/documentation/zoho-for-docusign/6e5ffa4161ae145cad6f13d4f71db2ce.webp)
     _\[Zoho org selection dialog showing CRM service and organization list with Submit button]_

7. **Step 4b — Review and Accept Permissions:**

8. Zoho will display the list of permissions being requested (CRUD operations on modules, user data access, metadata). Check the **"I allow Docusign Production to access the above data from my Zoho account"** checkbox, then click **Accept**.
   * ![Docusign Production consent screen requests access to CRM and Portfolio data with user permissions.](https://fluidlabs.com/images/documentation/zoho-for-docusign/d0cdf56ce4b5555bea756d637990a20c.webp)
     _\[Zoho permissions review screen with checkbox checked and Accept button]_

9. **Completion:** You will be redirected back to the Docusign App Center. The app status will show as **Installed** and the connection is ready to use in workflows.

### Managing Connections

You can edit, delete, or add new connections at any time without reinstalling the app.

To access connection settings:

1. Go to the **Docusign App Center** and open the **Zoho CRM** app page.
2. Click the **Manage** dropdown in the top right corner.
3. Select **Manage Connections**.
   * ![Zoho CRM app page showing a dropdown menu open to "Manage Connections."](https://fluidlabs.com/images/documentation/zoho-for-docusign/4dc7880745b75a5ea5409c9ee4a37d20.webp)
     _\[Manage dropdown showing: Add New Connection, Manage Connections, Manage Apps, Uninstall App]_

You will be taken to the **Connections** page, which lists all active connections with their type, status, and the user who created them.

To manage an individual connection, click the **three dots (⋮)** menu next to it:

* ![User interface shows Zoho CRM connection with 'Reconnect' option selected in a dropdown menu.](https://fluidlabs.com/images/documentation/zoho-for-docusign/d4036b1ae3a2f85e59c6cbecc5d8392b.webp)
  _\[Connections list showing Zoho CRM-Demo as Shared/Active, with three-dot menu open showing Edit connection name, Reconnect, Reload Objects, Delete Connection]_

#### Available Actions:

* **Edit connection name:** Rename the connection for better clarity.
* **Reconnect:** Force a reconnection to refresh tokens or update permissions.
* **Reload Objects:** Refresh the list of available Zoho CRM modules and fields. Use this if you have added new custom modules in Zoho and they are not yet appearing in the workflow builder.
* **Delete Connection:** Remove the connection.
  ⚠️ Warning: This may break existing workflows that use this connection.

### Adding a New Connection

To connect an additional Zoho CRM organization, you can either:

* Click the **Manage** dropdown on the app page and select **Add New Connection**, or
* Click the **+ Add New Connection** button directly on the Connections page.

![Zoho CRM connections page showing an active connection and the 'Reconnect' option highlighted.](https://fluidlabs.com/images/documentation/zoho-for-docusign/f190ec789a149153aa0add65180f616c.webp)

Follow the same setup steps as the initial installation.


## How to use App

The Zoho CRM app enables you to work with Zoho CRM data directly within Docusign Workflows. Using this app, you can create workflows that read data from Zoho CRM, update Zoho CRM records, and automatically attach signed documents as part of an automated process.

### Create a Workflow Builder To start using the integration, you first need to create a Workflow in Docusign.

1. Log in to Docusign.
2. Navigate to **Agreements → Workflows**.
3. Click **Create Workflow**.
   * ![Workflow management dashboard showing a list of processes, search, filter, and creation options.](https://fluidlabs.com/images/documentation/zoho-for-docusign/11d14987e72394cdda46bafaa286f967.webp)
     _\[Docusign Workflows screen with Create Workflow button]_
4. Build your workflow using the available steps, including Zoho CRM actions provided by the app.
5. Publish the workflow when ready.

### Available Zoho CRM Actions

Within the Workflow Builder, the Zoho CRM app provides actions to interact with your data. These actions allow Zoho CRM to act as both a source and a destination within the same workflow.

The following actions are available:

* **Read from Zoho CRM** — Retrieve data from a Zoho CRM record (e.g., Contact or Lead details).
* **Writeback to Zoho CRM** — Update existing records or create new ones in Zoho CRM based on the workflow output.
* **File Upload Zoho CRM** — Attach a specific file (e.g., a signed agreement) to a Zoho CRM record.

![Modal for adding a new step, showing Zoho CRM integration options after searching.](https://fluidlabs.com/images/documentation/zoho-for-docusign/ff97739d318b1d1e0e0a4fb217b66d73.webp)

_\["Add New Step" dialog with "Zoho" searched, showing all three Zoho CRM actions]_

### Configuring Actions: Workflow Start

In this documentation, we use `object_id` as the workflow startup variable. This is a common pattern when triggering workflows from an external system via API.

To configure the workflow trigger:

#### Step 1 — Select Trigger Type

Select **From an API Call** as the workflow start method.

* ![User interface showing 'From an API Call' selected as the workflow start method.](https://fluidlabs.com/images/documentation/zoho-for-docusign/5ccd3b437f92b83615c46a852ca6df34.webp)
* _\["Add workflow start" dialog with "From an API Call" selected in the dropdown]_

#### Step 2 — Create the object\_id Variable

Create a variable named **object\_id** (Type: **Text**).

* ![Workflow setup screen displaying variable configuration, 'Object\_id' input highlighted by a red arrow.](https://fluidlabs.com/images/documentation/zoho-for-docusign/6b6f4c6686d6abb83e2f02832cbf9b25.webp)
* _\["Set up variables" step showing object\_id variable of type Text]_

#### Step 3 — Select Process Type

Choose **Automated process** as the trigger type.

* ![Workflow configuration panel with steps for API call setup, asking if human or automated start.](https://fluidlabs.com/images/documentation/zoho-for-docusign/387be9814026b714f747854256684aea.webp)
* _\[Step 3 showing "Automated process" selected]_

This configuration allows external systems to trigger the workflow and pass a specific identifier (such as a Zoho CRM record ID) into the `object_id` variable. This variable can then be used in subsequent steps (like **Read from Zoho CRM**) to identify which record to process.


## Read from Zoho CRM 

The **Read from Zoho CRM** step allows a workflow to retrieve data from any Zoho CRM module. To do this correctly, the workflow must be able to identify which specific record it should work with.

### Step Overview

Configuring this step involves three main stages:

1. Selecting the Zoho CRM connection and module (object).
2. Choosing which fields to read (retrieve).
3. Defining the rule to identify the target record.

### 1. Add the Step to Your Workflow

1. In your workflow builder, click **+ Add Step**.

2. Search for and select **Read from Zoho CRM**.

3. Once the block appears, click **Configure** to start the setup.

   * ![Workflow card for 'Read from Zoho CRM' with a blue icon and 'Configure' button.](https://fluidlabs.com/images/documentation/zoho-for-docusign/468d1f16dab815f31b15f815c7f9f521.webp)
   * _\["Read from Zoho CRM" step block in the workflow builder with the Configure button]_

### 2. Configure Connection and Object

You will be prompted to select where to read data from.

1. **Connection:** Choose the Zoho CRM connection you created earlier (e.g., "Zoho CRM - Demo (Shared)").

2. **Zoho CRM object:** Select the module you want to work with. The integration currently supports the following modules:

   * Accounts
   * Contacts
   * Vendors
   * Deals
   * Leads
   * ![User interface configuring data read from Zoho CRM, selecting 'Contacts' from a dropdown.](https://fluidlabs.com/images/documentation/zoho-for-docusign/211ab29ba68331abe9b6fa15b7d99bf3.webp)
   * _\[Object dropdown open showing the list of available Zoho CRM modules]_

   > _💡 **Note:** The configuration logic described below is identical for all five supported modules - select your fields, define the matching rule, and the retrieved data becomes available as workflow variables. The examples in this guide use the **Contacts** module._

3. In this example, select **Contacts**.

   * ![A form showing the configuration for reading data from Zoho CRM, selecting 'Contacts' object.](https://fluidlabs.com/images/documentation/zoho-for-docusign/6cf70fd7922a6aeb0220a1ca9e9aef7b.webp)
   * _\[Connection and Object configured with Contacts selected, Next button visible]_

4. Click **Next**.

### 3. Select Fields

Choose the specific data points you want to retrieve from the Zoho CRM record.

1. Click **Add or Remove Fields**.

   * ![Software interface configuring Zoho CRM data read, selecting fields with 'Add or Remove Fields' button.](https://fluidlabs.com/images/documentation/zoho-for-docusign/d975e9a7be2f1d8dc90bf997af527990.webp)
   * _\[Fields step showing the Add or Remove Fields button with Contact ID already selected]_

2. A field browser will open showing all available fields for the selected module. Select the fields you need (e.g., _Name, Contact ID, First Name, Last Name, Full Name, Email, Phone, Account Name_, etc.).

   * ![Add or Remove Fields interface showing a list of system fields with checkboxes for selection.](https://fluidlabs.com/images/documentation/zoho-for-docusign/fc614b4caafb2d69e748c518238f6e94.webp)
   * _\["Add or Remove Fields" browser showing the Contacts module field list with multiple fields selected]_

3. The selected fields will become available as workflow variables for use in later steps.

4. Click **Next**.

> _💡 **Note:** For information on working with special field types, data formatting rules, and other nuances specific to Zoho CRM, refer to the _[_Implementation Guide & Known Behaviors_](https://fluidlabs.com/documentation/zoho-for-docusign#implementation-guide--known-behaviors)_._

### 4. Identify the Record

In this step, you define which specific Zoho CRM record the workflow should read. You do this by creating a matching rule.

Create a rule that matches a Zoho CRM field to a workflow variable:

* **Zoho CRM field:** Select a unique identifier field (e.g., `Contact ID (string)`).

* **Operator:** Select `Equal to`.

* **Workflow field:** Select the variable that contains the identifier (e.g., `object_id`, configured at the workflow start).

  * ![Zoho CRM field matching Contact ID to Workflow field object\_id, then clicking Done.](https://fluidlabs.com/images/documentation/zoho-for-docusign/7929c3e306e05b5395c13ecb4d0e904d.webp)
  * _\[Step 3 "Which records are you reading from?" showing Contact ID matched to object\_id variable]_

> _**Example Logic:** This rule tells the system: "Find the Zoho CRM Contact whose Contact ID matches the object\_id provided when the workflow started."_

Click **Done**. The rule is now saved.

Once configured, this step will find the correct record in Zoho CRM and pull the selected field data into the workflow as variables. You can now use these variables in subsequent steps (e.g., to pre-fill a document or pass data to a Writeback step).


## Writeback to Zoho CRM

The **Writeback to Zoho CRM** step allows a workflow to update existing records or create new ones in Zoho CRM using data collected during the workflow (e.g., from a signed document or a web form).

### Step Overview

This step is typically used at the end of a workflow to save results back to Zoho CRM. A common pattern:

1. Read record data from Zoho CRM.
2. Send documents for signature using that data.
3. Receive updated information from the signer.
4. Writeback: update the record in Zoho CRM with the new data.

### 1. Add the Step to Your Workflow

1. In your workflow builder, click **+ Add Step**.

2. Search for and select **Writeback to Zoho CRM**.

3. Once the block appears, click **Configure** to start the setup.

   * ![A workflow card showing 'Writeback to Zoho CRM' with a 'Configure' button.](https://fluidlabs.com/images/documentation/zoho-for-docusign/843904cf73319032bbfa55b58f48ea77.webp)
   * _\["Writeback to Zoho CRM" step block in the workflow builder with the Configure button]_

### 2. Configure Connection and Object

1. **Connection:** Select your Zoho CRM connection (e.g., "Zoho CRM - Demo (Shared)").

2. **Zoho CRM object:** Select the module you want to write to. The same five modules are supported: Accounts, Contacts, Vendors, Deals, and Leads.

   * ![Zoho CRM writeback form displaying object selection with 'Contacts' highlighted.](https://fluidlabs.com/images/documentation/zoho-for-docusign/a13a4a147b7120f59472081e2d8a648b.webp)
   * _\[Object dropdown open showing the five available modules with Contacts highlighted]_

3. **Write settings:** Choose how the system should handle the data:

   * **Update or Create** (Recommended) - checks if a matching record exists; updates it if found, or creates a new one if not.
   * **Update** - updates an existing record only. Fails if no match is found.
   * **Create** - always creates a new record, regardless of whether one already exists.
   * ![Software interface showing Zoho CRM writeback settings with 'Update or Create' selected.](https://fluidlabs.com/images/documentation/zoho-for-docusign/425de831c593704913ad1012a425f1b5.webp)
   * _\[Write settings section showing the three options with "Update or Create" selected]_

4. Click **Next**.

### 3. Map Fields

In this step, you map workflow data to the corresponding Zoho CRM fields. This tells the system where to write each piece of data.

1. Click **Add or Remove Fields** to select which Zoho CRM fields you want to populate.

   * ![A digital form showing fields for personal details and CRM-related data variables.](https://fluidlabs.com/images/documentation/zoho-for-docusign/f1757af349ea2d73850fd6eaaaf0a9b8.webp)
   * _\[Fields step showing field list with Last Name marked as mandatory (red asterisk)]_

2. For each field, select the source variable from your workflow. Data can come from any previous step - for example, from a **Send Documents for Signature** step (i.e., data filled in by the signer on the signed form).

   * ![Software interface for field mapping, showing 'Lead Name' selected from a dropdown list.](https://fluidlabs.com/images/documentation/zoho-for-docusign/5f00b85cb903221de8d5d00ad52f5b9d.webp)
   * _\[Field mapping dropdown showing variables from "Send Documents for Signature" step highlighted]_

   > _⚠️ **Mandatory fields:** Each Zoho CRM module has required fields marked with a red asterisk (e.g., **Last Name** for Contacts). These fields must be mapped for the step to work. They are also used by the connector to identify whether to update an existing record or create a new one. For the full list of mandatory fields per module, refer to the [Implementation Guide & Known Behaviors](https://fluidlabs.com/documentation/zoho-for-docusign#implementation-guide--known-behaviors)._

3. Click **Next**.

### 4. Identify the Record

Define which specific record in Zoho CRM the workflow should write to by creating a matching rule.

* **Zoho CRM field:** Select a field that can uniquely identify the record (e.g., `Email (string)`).

* **Operator:** Select `Equal to`.

* **Workflow field:** Select the corresponding workflow variable (e.g., `Email` from the signed form).

  * ![Setting up a workflow rule to connect Zoho CRM email to a workflow email field.](https://fluidlabs.com/images/documentation/zoho-for-docusign/a7cd2545f9901e193fd8a70a6ec55d1e.webp)
  * _\[Step 3 showing Email field matched to Email workflow variable]_

> _⚠️ **Important:** The identifier field must be unique in your Zoho CRM data. If the system finds multiple records matching the rule (e.g., two contacts with the same email), the step will fail. Use the most reliable unique field available, or refer to the _[_Implementation Guide & Known Behaviors_](https://fluidlabs.com/documentation/zoho-for-docusign#implementation-guide--known-behaviors)_ for guidance._

Click **Done**. The step is now configured and will automatically update or create Zoho CRM records when the workflow runs.


## File Upload Zoho CRM

The **File Upload Zoho CRM** step allows a Workflow to upload and attach a file directly to a record in Zoho CRM.

### Add the Step to Your Workflow

1. In your workflow builder, click **+ Add Step**.

2. Search for and select **File Upload Zoho CRM**.

3. Once the block appears, click **Configure** to start the setup.

   * ![UI module for File Upload Zoho CRM with a Configure button.](https://fluidlabs.com/images/documentation/zoho-for-docusign/f73ffab4fd76474b02bbb64f1f12ee24.webp)
   * _\["File Upload Zoho CRM" step block in the workflow builder with the Configure button]_

### 2. Select the File to Upload

Select which file from the workflow should be uploaded.

* **Select a file or envelope:** Choose **Combined Envelope File** (or another file variable generated by a previous step).

  * ![Workflow interface showing "Shop Name" input and selecting "Combined Envelope File" under "What are you sharing?".](https://fluidlabs.com/images/documentation/zoho-for-docusign/28dfe8fe0193f8999bfd55af895e1e57.webp)
  * _\[Step 1 "What are you storing?" with Combined Envelope File option visible in the dropdown]_

> _💡 If no file is available in the dropdown, it means the file has not been generated yet at this point in the workflow. Make sure a **Send Documents for Signature** (or something is generating this file) step exists before the File Upload step._

### 3. Choose the Upload Location

1. **Select connection:** Choose your Zoho CRM connection (e.g., "Zoho CRM - Demo (Shared)").

   * ![UI showing 'Select connection' dropdown with 'Zoho CRM - Demo (Shared)' chosen for file upload.](https://fluidlabs.com/images/documentation/zoho-for-docusign/1ed11d2f9a8f4819e85089bd42bfda1e.webp)
   * _\[Step 2 "Where are you storing it?" with connection selected and empty drive dropdown]_

2. **Select drive:** Choose the Zoho CRM module you want to attach the file to. Each option includes a helpful hint about how the folder structure will work:

   * Accounts (Use Account ID as new folder name)
   * **Contacts (Use Contact ID as new folder name)**
   * Deals (Use Deal ID as new folder name)
   * Leads (Use Lead ID as new folder name)
   * Vendors (Use Vendor ID as new folder name)
   * ![Zoho CRM file upload configuration showing 'Select drive' dropdown with 'Contacts' option highlighted.](https://fluidlabs.com/images/documentation/zoho-for-docusign/110afcca5b15dd53506125a9ae96e478.webp)
   * _\[Drive dropdown open showing all five module options with Contacts highlighted]_

3. **Select folder:** After selecting the drive, click **Add Folder +** to define where within the module the file will be attached. 

   ![Form displaying Zoho CRM connection selected and a highlighted 'Add Folder' button.](https://fluidlabs.com/images/documentation/zoho-for-docusign/45fb020b35de05dec54a263383d0ef0c.webp)

4. You have two options:

#### Method A - Select a Record from the List

After clicking **Add Folder +**, a dropdown will show existing records from your Zoho CRM (displayed as `Name#RecordID`). Select the specific record you want to attach the file to.

* ![User interface for a pre-upload data offer, highlighting the selection of a folder named 'Alex Moran'.](https://fluidlabs.com/images/documentation/zoho-for-docusign/7c823de5112241198e20e8b9227f7692.webp)
* _\[Select folder dropdown showing existing Zoho CRM contacts by name and ID, with New Subfolder option at the bottom]_
* **Result:** The file will always be attached to this specific record, regardless of who is involved in the workflow run.
* **Use case:** Useful when all files should go to a single central record (e.g., a shared company account).

#### Method B - Attach Dynamically via Record ID

This method uses the record ID retrieved from an earlier **Read from Zoho CRM** step to dynamically attach the file to the correct record for each workflow run.

1. In the **Select folder** dropdown, choose **New Subfolder**.

   * ![UI dropdown menu displaying folder options with a highlighted 'New Subfolder' selection.](https://fluidlabs.com/images/documentation/zoho-for-docusign/a178715692788ca154bec7fda6a6afdc.webp)
   * _\[Select folder dropdown with "New Subfolder" highlighted]_

2. In the **New folder** dialog, click **Add Variable**.

   * ![New folder dialog showing variable selection for folder names like 'Contacts\[\] / Contact ID'.](https://fluidlabs.com/images/documentation/zoho-for-docusign/cb9418db94b2a435f6ba742b3e7f6f1e.webp)
   * _\["New folder" dialog with Add Variable dropdown open, showing Read from Zoho CRM as the source and Contact ID as the suggested variable]_

3. Select the variable source **Read from Zoho CRM** and choose **Contact ID** (or the relevant ID field for your module).

4. The folder name field will populate with the ID variable (e.g., `Contacts[1] / Contact ID`). Click **Add**.

   * ![New folder modal for creating a folder name using a variable.](https://fluidlabs.com/images/documentation/zoho-for-docusign/4323d5f621fa6ff227793e3ddc279a55.webp)
   * _\["New folder" dialog showing "Contacts\[1] / Contact ID" as the folder name, with Add button]_

5. The **Select folder** field will now show `[Contacts[1] / Contact ID]`.

   * ![Screenshot of a user interface for selecting file upload connections, drives, and folders, with a 'Next' button.](https://fluidlabs.com/images/documentation/zoho-for-docusign/3c4db7d7e8948c9d9fe1d307762e3ddf.webp)
   * _\[Location step showing connection, Contacts drive, and the Contact ID variable in the folder field, with Next button]_

6. **Result:** The file will be attached to the specific record involved in the current workflow run.

7. **Use case:** The recommended approach for universal workflows where signed documents need to reach the correct client record automatically.

Click **Next**.

### 4. Name the File

Use variables and text to create a custom file name.

1. Click **Add Variable** to insert a workflow variable, or **Add Text** to type a static name.

2. Enter your desired file name (e.g., `Signed-MSA`).

3. The **File path** preview at the bottom will show the full path where the file will be stored.

   * ![User interface for uploading a file to Zoho CRM, showing the 'Signed MSA' file name.](https://fluidlabs.com/images/documentation/zoho-for-docusign/45571c7860e32b85d80e28da972d1db2.webp)
   * _\[Step 3 "What will you call it?" showing "Signed-MSA" as the file name and the full file path preview]_

4. Click **Apply**.

Once the workflow runs, the file will be attached to the specified record in Zoho CRM. To verify, open the record in Zoho CRM and navigate to the **Attachments** section — the uploaded file will appear there, listed with the source as **Docusign**.

* ![CRM contact page showing "Mr. Alexander Vance" details with a highlighted PDF attachment.](https://fluidlabs.com/images/documentation/zoho-for-docusign/d0a72e826ebfc84aa9f5b6d54be5412f.webp)
* _\[Zoho CRM Contact record showing the signed PDF in the Attachments section, uploaded by Docusign]_


## FAQ & Troubleshooting

### FAQ & Troubleshooting

Here are the most common configuration issues and how to resolve them.

### File Upload Issues

**Q: I don't see any files available in the "Select a file or envelope" dropdown.**

A: This happens when the workflow hasn't generated a file yet at the point where the File Upload step is placed.

* **Cause:** No document has been generated before this step.
* **Solution:** Make sure a **Send Documents for Signature** (or other step that generates document) step exists before the File Upload step in your workflow.

**Q: The file upload is failing or the file is going to the wrong record.**

A: This is usually caused by an incorrect folder configuration in the upload location.

* **Cause:** The **New Subfolder** is either missing or was configured with a text value instead of the Contact ID variable.
* **Solution:** In the File Upload step, make sure the **Select folder** field uses the ID variable from the **Read from Zoho CRM** step (e.g., `[Contacts[1] / Contact ID]`), not a static text name. See the[ File Upload Zoho CRM](https://fluidlabs.com/documentation/zoho-for-docusign#file-upload-zoho-crm) guide for the full configuration steps.

### Writeback Issues

**Q: The Writeback step created a duplicate record instead of updating the existing one.**

A: This happens when the matching rule in Step 3 doesn't find the correct record.

* **Cause:** The identifier field used in the rule (e.g., Email) either doesn't match any existing record, or the field value isn't unique and matches multiple records.
* **Solution:** Make sure the identifier field is unique across your Zoho CRM data. If duplicates exist, use a more reliable field.

**Q: The Writeback step is failing and won't save.**

A: Check whether all mandatory fields are mapped.

* **Cause:** Each Zoho CRM module has required fields (marked with a red asterisk in the UI) that must be populated for the step to work. For example, **Last Name** is mandatory for Contacts.
* **Solution:** Open the Writeback step configuration and make sure all required fields have a mapped workflow variable. Refer to the [Implementation Guide & Known Behaviors](https://fluidlabs.com/documentation/zoho-for-docusign#implementation-guide--known-behaviors) for the full list of mandatory fields per module.

**Q: The Writeback step fails with a generic error like **`AxiosError`**.**

A: This is typically a data formatting issue on a specialized field.

* **Cause:** Zoho CRM enforces strict formatting rules on certain fields. For example, the `Twitter` field rejects values containing spaces, and currency or number fields reject any alphabetic characters. When Zoho returns a 400 Bad Request, the connector may display a generic error instead of the specific validation message.
* **Solution:** Double-check the format and data type of all values being passed to specialized fields. Refer to the [Implementation Guide & Known Behaviors](https://fluidlabs.com/documentation/zoho-for-docusign#implementation-guide--known-behaviors) for more details.

### Connection Issues

**Q: The workflow is failing with a token or authentication error.**

A: The connection to Zoho CRM may have expired or lost its authorization.

* **Solution:**

  1. Go to the **Docusign App Center** and open the **Zoho CRM** app page.
  2. Click **Manage → Manage Connections**.
  3. Find the affected connection, click the **three dots (⋮)** menu, and select **Reconnect**.
  4. Complete the Zoho authorization flow again.

### Lokup Field Issues

**Q: A Writeback step fails when trying to link a related record (e.g., Account or Reporting To).**

A: This is caused by mapping both the Name and the ID for the same lookup field simultaneously.

* **Cause:** The Zoho CRM API does not allow both the Name and the ID of the same relationship to be sent at the same time. If both are populated in the workflow, the operation will fail.
* **Solution:** Choose one method per relationship - either map the Name or the ID, but never both. If duplicate names exist in your Zoho CRM data, always prefer the ID. For full details, refer to the [Implementation Guide & Known Behaviors](https://fluidlabs.com/documentation/zoho-for-docusign#implementation-guide--known-behaviors).

---

Zoho CRM for Docusign IAM is published by Fluidlabs. Docusign is a trademark of Docusign, Inc.