---
canonical_url: "https://docs.composio.dev/toolkits/zoho_sign"
markdown_url: "https://docs.composio.dev/toolkits/zoho_sign.md"
product: "platform"
version: null
last_updated: null
---

# Zoho Sign

Zoho Sign provides electronic signature workflows for creating, sending, tracking, and managing documents, templates, recipients, and account resources.

- **Category:** signatures
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 43
- **Triggers:** 0
- **Slug:** `ZOHO_SIGN`
- **Version:** 00000000_00

## Tools

### Create Folder

**Slug:** `ZOHO_SIGN_CREATE_FOLDER`

Create a persistent Zoho Sign folder. Zoho Sign provides no folder-delete API endpoint, so this action cannot automatically clean up the folder.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_name` | string | Yes | Name for the new folder. The folder persists after creation because Zoho Sign provides no folder-delete API endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Request

**Slug:** `ZOHO_SIGN_CREATE_REQUEST`

Upload 1-40 PDF documents and create a Zoho Sign draft request. This action does not send the request to recipients.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | Yes | PDF documents to add to the draft. Provide 1-40 files, each no larger than 25 MB, with a combined size no larger than 40 MB. |
| `actions` | array | No | Optional recipient actions; omit to create a recipient-free draft. |
| `settings` | object | Yes | Draft request settings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Request From Merged Templates

**Slug:** `ZOHO_SIGN_CREATE_REQUEST_FROM_MERGED_TEMPLATES`

Create one Zoho Sign request from two or more compatible templates. quick_send=true immediately submits the request and irreversibly emails external recipients, requiring a paid API-capable plan and submission credits. This endpoint's page does not guarantee that quick_send=false creates a draft, so use false only when that uncertainty is acceptable.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `notes` | string | No | Common notes attached to the merged request; omit for no notes. |
| `actions` | array | Yes | Recipient mappings based on Merge View output; include each action that must be assigned in the merged request. |
| `field_data` | object | No | Prefill values for fields in the merged templates. Omit when no merged template fields need prefilled values. |
| `quick_send` | boolean | Yes | Required explicit send choice. true immediately submits the request and irreversibly emails external recipients, requiring a paid API-capable Zoho Sign plan and submission credits. The Merge Send page does not guarantee draft-only behavior when false. |
| `template_ids` | array | Yes | Two or more compatible template IDs previously checked with Merge View, in the order they should be merged. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Request From Template

**Slug:** `ZOHO_SIGN_CREATE_REQUEST_FROM_TEMPLATE`

Create a Zoho Sign request from a template. quick_send must be chosen explicitly: true irreversibly emails external recipients and requires a paid API-capable plan and send credits; false creates an editable draft.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `notes` | string | Yes | Common message sent to all recipients. |
| `actions` | array | Yes | Template role assignments and recipients; include every action defined by the template. |
| `quick_send` | boolean | Yes | Explicitly choose whether to send immediately. true irreversibly emails recipients and requires a paid API-capable Zoho Sign plan and send credits; false creates an editable draft without sending. |
| `template_id` | string | Yes | Template ID used to create the request. |
| `request_name` | string | No | Name for the generated request; Zoho uses the template name if omitted. |
| `field_date_data` | object | No | Template prefill date values keyed by field label or name. |
| `field_text_data` | object | No | Template prefill text values keyed by field label or name. |
| `field_boolean_data` | object | No | Template prefill checkbox values keyed by field label or name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Request Type

**Slug:** `ZOHO_SIGN_CREATE_REQUEST_TYPE`

Create a persistent Zoho Sign document/request type. Zoho Sign provides no request-type delete API endpoint, so this action cannot automatically clean up the request type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name for the new request type. The request type persists after creation because Zoho Sign provides no request-type delete API endpoint. |
| `description` | string | No | Optional description for the new request type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Signer Group

**Slug:** `ZOHO_SIGN_CREATE_SIGNER_GROUP`

Create a persistent Zoho Sign signer group with named email recipients. Zoho Sign provides no signer-group delete API endpoint, so this action cannot automatically clean up the group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name for the signer group. The group persists after creation because Zoho Sign provides no signer-group delete API endpoint. |
| `recipients` | array | Yes | People who can satisfy signing actions assigned to this group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Template

**Slug:** `ZOHO_SIGN_CREATE_TEMPLATE`

Upload 1-40 PDF documents and create a reusable Zoho Sign template with recipient roles and signer fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | Yes | PDF template documents to upload. Provide 1-40 files, each no larger than 25 MB, with a combined size no larger than 40 MB. |
| `notes` | string | No | Template notes. |
| `actions` | array | Yes | Reusable recipient roles and their assigned fields. |
| `folder_id` | string | No | Folder ID returned by List Folders. |
| `is_sequential` | boolean | Yes | Whether assigned recipients must act in signing order. |
| `template_name` | string | Yes | Reusable template name. |
| `email_reminders` | boolean | No | Whether automatic reminders are enabled by default. |
| `expiration_days` | integer | No | Default request expiration in days. |
| `reminder_period` | integer | No | Default number of days between reminders. |
| `request_type_id` | string | No | Request type ID returned by List Request Types. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Document

**Slug:** `ZOHO_SIGN_DELETE_DOCUMENT`

Permanently delete one document file from an owned Zoho Sign request. This destructive action cannot be undone and does not delete the whole request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `document_id` | string | Yes | Document file ID to permanently remove from its Zoho Sign request. This cannot be undone and does not delete the whole request; only use an owned document when permanent deletion is intended. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Request

**Slug:** `ZOHO_SIGN_DELETE_REQUEST`

Destructively move an owned Zoho Sign request to trash. This is a soft delete rather than immediate permanent erasure. Optionally recall an in-progress request first, which stops its remaining signing process.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reason` | string | No | Reason Zoho Sign should record for recalling or deleting the request. |
| `request_id` | string | Yes | Owned request ID to move to trash. This removes the request from active workflows; only delete a request when that destructive action is intended. |
| `recall_in_progress` | boolean | No | Whether to recall an in-progress request before moving it to trash. Recalling stops the remaining signing process. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Template

**Slug:** `ZOHO_SIGN_DELETE_TEMPLATE`

Destructively move an owned reusable Zoho Sign template to trash. This is a soft delete rather than immediate permanent erasure.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | Owned template ID to move to trash. This removes the reusable template from active use; only delete it when that destructive action is intended. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Completion Certificate

**Slug:** `ZOHO_SIGN_DOWNLOAD_COMPLETION_CERTIFICATE`

Download the PDF completion certificate for a fully signed request. Draft and in-progress requests do not have a certificate; completing a request through the API requires a paid API-capable Zoho Sign plan and credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Completed request ID whose PDF completion certificate to download. The request must already be fully signed; completing requests through the API requires a paid API-capable Zoho Sign plan and credits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Document

**Slug:** `ZOHO_SIGN_DOWNLOAD_DOCUMENT`

Download one PDF document from a Zoho Sign request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Request containing the document. |
| `document_id` | string | Yes | Document ID returned in the request's document_ids. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Request

**Slug:** `ZOHO_SIGN_DOWNLOAD_REQUEST`

Download all documents in a Zoho Sign request as a PDF or ZIP, optionally merged and including the completion certificate.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `merge` | boolean | No | Merge multiple documents into one PDF instead of returning a ZIP archive. |
| `request_id` | string | Yes | Request ID whose documents to download. |
| `archive_protection` | string | No | Password used to protect the downloaded PDF or ZIP archive when applicable. |
| `include_completion_certificate` | boolean | No | Include the completion certificate when it is available. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Email Completed Request

**Slug:** `ZOHO_SIGN_EMAIL_COMPLETED_REQUEST`

Immediately email an owned completed Zoho Sign request to one to three addresses. The request must have completed signing, which generally depends on the paid API submission workflow. This sends real external email; confirm every destination before calling, and check delivery before retrying to avoid duplicate messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Completed request ID whose documents should be emailed. The request must already have completed signing. |
| `email_addresses` | array | Yes | One to three destination email addresses. Calling this action immediately sends real external email containing the completed request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Extend Request

**Slug:** `ZOHO_SIGN_EXTEND_REQUEST`

Extend the signing-link expiration date of an owned sent request. The request must already have been submitted through Zoho Sign's paid, credit-consuming API-send workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expire_by` | string | Yes | New expiration date in DD Month YYYY format using an English month name, for example '30 November 2026'. |
| `request_id` | string | Yes | Owned sent request ID whose signing-link expiration should be extended. The request must have been submitted through the paid API-send workflow. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Embedded Signing URL

**Slug:** `ZOHO_SIGN_GENERATE_EMBEDDED_SIGNING_URL`

Generate a one-time URL for a human to sign one recipient action from a previously submitted request. The recipient must have been configured as an embedded SIGN action before submission; API submission requires a paid Zoho Sign plan and send credits. This action does not sign the document. Hand the URL to the intended signer immediately because it must be opened within two minutes and can be used only once.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `host` | string | No | Origin hosting the iframe, for example https://example.com. Required when the signing page will be rendered in an iframe; omit when opening it in a new tab or window. |
| `action_id` | string | Yes | Recipient action ID configured with action_type SIGN and is_embedded=true before the request was submitted. |
| `request_id` | string | Yes | Previously submitted request ID containing an embedded SIGN recipient. Submitting through the API requires a paid Zoho Sign plan and send credits. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Request Embedded Send URL

**Slug:** `ZOHO_SIGN_GENERATE_REQUEST_EMBEDDED_SEND_URL`

Generate a short-lived, human-facing embedded editor URL for an owned active draft request. Open the URL within two minutes to start a one-hour session. This action only creates the handoff URL; it does not send the request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Owned active draft request ID to open in Zoho Sign's embedded editor. The draft must already contain a recipient or role. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Template Embedded Send URL

**Slug:** `ZOHO_SIGN_GENERATE_TEMPLATE_EMBEDDED_SEND_URL`

Generate a short-lived embedded editor and sending URL for an owned Zoho Sign template. Open the URL within two minutes to start a one-hour human editing session. Generating the URL does not itself send a request; a completed send may require paid API entitlement and credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | Owned template ID to open in the embedded editor. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization

**Slug:** `ZOHO_SIGN_GET_ORGANIZATION`

Get the connected Zoho Sign organization, license label, administrative context, and relevant template, embedded-workflow, and signer-group feature flags.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Request

**Slug:** `ZOHO_SIGN_GET_REQUEST`

Get one request's status, documents, recipient actions, and signer fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Request ID returned by Create Request or List Requests. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Request Field Data

**Slug:** `ZOHO_SIGN_GET_REQUEST_FIELD_DATA`

Get recipient-entered field labels and values from a completed Zoho Sign request. Draft and in-progress requests do not have completed field data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Completed request ID whose recipient-entered field values to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Request Reminder Settings

**Slug:** `ZOHO_SIGN_GET_REQUEST_REMINDER_SETTINGS`

Get automatic email reminder settings for an owned Zoho Sign request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Request ID whose automatic reminder settings to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Template

**Slug:** `ZOHO_SIGN_GET_TEMPLATE`

Get one Zoho Sign template's documents, reusable recipient roles, signer fields, and prefill fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | Template ID returned by Create Template or List Templates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Field Types

**Slug:** `ZOHO_SIGN_LIST_FIELD_TYPES`

List account-specific Zoho Sign field type IDs, names, categories, and mandatory defaults for use when placing signer fields.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Folders

**Slug:** `ZOHO_SIGN_LIST_FOLDERS`

Return one controllable page of Zoho Sign folders.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | object | No | Page, sort, search, and continuation controls. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List My Requests

**Slug:** `ZOHO_SIGN_LIST_MY_REQUESTS`

Return one controllable page of requests assigned to or pending for the connected Zoho Sign user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | object | No | Page, sort, search, and continuation controls. |
| `request_status` | string | No | Zoho request status or category filter, such as my_pending. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Requests

**Slug:** `ZOHO_SIGN_LIST_REQUESTS`

Return one controllable page of Zoho Sign document requests, optionally filtered by status and search columns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | object | No | Page, sort, search, and continuation controls. |
| `request_status` | string | No | Zoho request status to filter by. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Request Types

**Slug:** `ZOHO_SIGN_LIST_REQUEST_TYPES`

Return one controllable page of Zoho Sign document request types.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | object | No | Page, sort, search, and continuation controls. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Signer Group Recipients

**Slug:** `ZOHO_SIGN_LIST_SIGNER_GROUP_RECIPIENTS`

Return one page of recipients for a Zoho Sign signer group. An empty result does not prove that the signer group exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | object | No | Page, sort, search, and continuation controls. |
| `signing_group_id` | string | Yes | Signer group ID whose recipients to list. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Signer Groups

**Slug:** `ZOHO_SIGN_LIST_SIGNER_GROUPS`

Return one controllable page of Zoho Sign signer groups, optionally filtered by group name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | object | No | Page, sort, search, and continuation controls. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Templates

**Slug:** `ZOHO_SIGN_LIST_TEMPLATES`

Return one controllable page of reusable Zoho Sign templates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | object | No | Page, sort, search, and continuation controls. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Users

**Slug:** `ZOHO_SIGN_LIST_USERS`

Return one controllable page of users in the connected Zoho Sign organization without email addresses or profile photos.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | object | No | Page, sort, search, and continuation controls. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Mark Request For Correction

**Slug:** `ZOHO_SIGN_MARK_REQUEST_FOR_CORRECTION`

Move an owned in-progress request into correction mode before any signer completes. The request must have been submitted through a paid, credit-consuming API-send workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | In-progress request ID to move into correction mode. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Merge Templates Into Request

**Slug:** `ZOHO_SIGN_MERGE_TEMPLATES_INTO_REQUEST`

Merge at least two owned templates into an existing owned Zoho Sign draft request. This updates the draft but does not submit it or send it to recipients.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `org_id` | string | No | Organization ID context. Zoho documents this field but not its datatype or requiredness. |
| `request_id` | string | Yes | Existing owned draft request ID to update. |
| `request_name` | string | No | Replacement request name to apply while merging. |
| `template_ids` | array | Yes | IDs of at least two owned templates to merge into the draft request. |
| `deleted_actions` | array | No | Action values to delete while merging. Zoho documents this as an array but does not publish its item schema. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Preview Template Merge

**Slug:** `ZOHO_SIGN_PREVIEW_TEMPLATE_MERGE`

Preview whether two or more Zoho Sign templates are compatible for merging and retrieve the merged fields and recipient roles. This read-only preview does not create a request or send anything.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_ids` | array | Yes | Two or more Zoho Sign template IDs to check for merge compatibility. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Recall Request

**Slug:** `ZOHO_SIGN_RECALL_REQUEST`

Irreversibly recall an owned sent Zoho Sign request and cancel its remaining signing process. Recipients can no longer view or sign the request after recall. The request must already have been submitted through the paid, credit-consuming API-send workflow.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Owned sent request ID to recall. Recalling permanently cancels the remaining signing process and prevents recipients from viewing or signing the request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remind Request Recipients

**Slug:** `ZOHO_SIGN_REMIND_REQUEST_RECIPIENTS`

Immediately send a real reminder email to every pending recipient of an owned sent request. This externally visible action requires the paid API-send workflow, and repeated calls send additional email reminders.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `request_id` | string | Yes | Owned sent request whose pending recipients should receive a reminder. A successful call immediately sends real external email; repeated calls send additional reminders. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Self Sign Request

**Slug:** `ZOHO_SIGN_SELF_SIGN_REQUEST`

Irreversibly apply the connected user's legal signature and complete an owned Zoho Sign self-sign request. The request must already be configured for self-signing and in a signable state. This requires an API-capable paid plan; confirm the request and field values before calling because signing cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `actions` | array | Yes | Existing self-sign actions with completed field values. A successful call applies an irreversible legal signature and completes the request. |
| `settings` | object | No | Current request values to include when Zoho's self-sign contract requires them. |
| `request_id` | string | Yes | Owned self-sign request ID to complete. The request must already be in a state that permits self-signing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Request

**Slug:** `ZOHO_SIGN_SUBMIT_REQUEST`

Irreversibly send an owned Zoho Sign draft request to its recipients after applying final signer fields. This requires an API-capable paid plan and send credits; Zoho documents a cost of five credits per envelope submission.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `actions` | array | Yes | Final recipient actions and signer fields. Submitting sends real emails, consumes Zoho Sign credits, and cannot be undone. |
| `request_id` | string | Yes | Owned draft request ID to send. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Request

**Slug:** `ZOHO_SIGN_UPDATE_REQUEST`

Update an owned draft or correction-mode request, including settings, recipients, fields, and optional added files. This does not send the request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | Optional documents to append or replace, up to 40 files, 25 MB each and 40 MB total. |
| `actions` | array | Yes | Recipient actions and fields to add or update, up to 25 recipients. |
| `settings` | object | Yes | Complete request settings; request_name and is_sequential are required. |
| `request_id` | string | Yes | Draft or correction-mode request ID to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Request Type

**Slug:** `ZOHO_SIGN_UPDATE_REQUEST_TYPE`

Rename or change the description of an existing Zoho Sign document request type.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Replacement request type name. |
| `description` | string | No | Replacement request type description. |
| `request_type_id` | string | Yes | Request type ID to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Signer Group

**Slug:** `ZOHO_SIGN_UPDATE_SIGNER_GROUP`

Rename an owned Zoho Sign signer group, add recipients, and remove existing recipients by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Replacement signer group name. |
| `recipients` | array | No | New recipients to add to the signer group. |
| `signing_group_id` | string | Yes | Signer group ID to update. |
| `delete_recipient_ids` | array | No | Existing recipient IDs to remove from the signer group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Template

**Slug:** `ZOHO_SIGN_UPDATE_TEMPLATE`

Update an owned Zoho Sign template's settings, reusable roles, signer fields, field removals, and optional added PDF documents.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | Optional PDF documents to add, up to 40 files, each no larger than 25 MB and with a combined upload size no larger than 40 MB. |
| `notes` | string | No | Replacement template notes. |
| `actions` | array | No | Role actions, fields, and deleted field IDs to update. |
| `folder_id` | string | No | Replacement folder ID. |
| `template_id` | string | Yes | Owned template ID to update. |
| `is_sequential` | boolean | No | Replacement sequential-signing setting. |
| `template_name` | string | No | Replacement template name. |
| `document_fields` | array | No | Document-level fields to add or update and existing field IDs to remove. |
| `email_reminders` | boolean | No | Replacement automatic reminder setting. |
| `expiration_days` | integer | No | Replacement default expiration in days. |
| `reminder_period` | integer | No | Replacement reminder interval in days. |
| `request_type_id` | string | No | Replacement request type ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |