# Eversign

Xodo Sign is a cloud-based digital signature solution that allows users to sign, send, and manage documents online.

- **Category:** signatures
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `EVERSIGN`
- **Version:** 20260223_00

## Tools

### Get Document Audit Log

**Slug:** `EVERSIGN_AUDIT_LOG`

Retrieves the complete audit trail for a document, showing all events from creation through completion. Use this after obtaining a document_hash from list_documents or create_document to track document lifecycle events, signer actions, and status changes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `document_hash` | string | Yes | The unique identifier (hash) of the document to retrieve history for. |

#### 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 Document

**Slug:** `EVERSIGN_CREATE_DOCUMENT`

Creates a new Eversign document for electronic signature collection from one or more signers. You can create documents either: 1. From a template (use EVERSIGN_LIST_TEMPLATES to find available templates, then specify template_id) 2. From uploaded files (provide file URLs, base64 content, or file IDs in the files array) Documents can be sent immediately to signers or saved as drafts. Use sandbox mode for testing. Returns the document_hash which can be used to track and manage the document.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meta` | object | No | Custom metadata key-value pairs to attach to the document |
| `files` | array | No | PDF or document files to include (via URL, Base64, or file_id) |
| `title` | string | No | Custom document title/name (requires premium plan - omit to use template's default title) |
| `fields` | array | No | Form fields to place on the document for signers to fill |
| `message` | string | No | Custom message sent to all signers in invitation email (requires premium plan - omit to use default) |
| `sandbox` | boolean | No | Set to true to create document in sandbox/test mode for testing (documents are marked as non-binding) |
| `signers` | array | Yes | List of signers who must sign the document (at least one required) |
| `is_draft` | boolean | No | Set to true to save as draft without sending to signers (can be sent later) |
| `redirect` | string | No | URL to redirect signers to after completing the signature |
| `reminders` | boolean | No | Enable automatic reminder emails to signers |
| `recipients` | array | No | CC recipients who receive the completed document but don't sign |
| `template_id` | string | No | Template document hash to use as base for this document (use EVERSIGN_LIST_TEMPLATES to find available templates) |
| `use_signer_order` | boolean | No | Enable sequential signing (signers must sign in order) |
| `require_all_signers` | boolean | No | Require all signers to sign for completion (vs. any one signer) |
| `embedded_signing_enabled` | boolean | No | Enable embedded signing (displays signing in iframe) |

#### 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:** `EVERSIGN_CREATE_TEMPLATE`

Tool to create a new template. Use when you need to programmatically set up reusable document templates after confirming your business settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | List of file objects to attach to the template. |
| `fields` | array | No | 2-dimensional array of form fields - one array per file. Each file's array contains its field specifications. Provide an empty array [] for files without fields. |
| `expires` | integer | No | Unix timestamp (seconds since epoch) when the document should expire. Must be a future date. |
| `sandbox` | boolean | No | If true, the template is created in the sandbox environment. |
| `signers` | array | No | List of signer roles for the template. Each role represents a type of signer (e.g., 'Client', 'Manager') rather than a specific person. |
| `reminders` | object | No | Reminder settings for the template. |
| `template_note` | string | No | Optional internal notes for the template. |
| `template_title` | string | Yes | Title of the template to be created. |
| `template_message` | string | No | Optional message body to associate with the template. |
| `require_all_signers` | boolean | No | If true, all signers must complete before finalization. |

#### 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 or Template

**Slug:** `EVERSIGN_DELETE_DOCUMENT_OR_TEMPLATE`

Tool to delete, cancel, or trash a document or template by its hash. Usage: - To cancel a pending/in-process document: Set cancel=True - To trash a document (safer, reversible): Set trash=True - To permanently delete a draft or cancelled document: Use without cancel or trash flags Note: Draft and completed documents must be trashed before permanent deletion. Pending documents must be cancelled before deletion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `trash` | boolean | No | Set to True to move a document to trash instead of permanently deleting it. Draft and completed documents must be trashed before they can be permanently deleted. This is a safer option than permanent deletion. |
| `cancel` | boolean | No | Set to True to cancel a pending/in-process document. Cancelled documents can then be permanently deleted. Use this for documents that are awaiting signatures. |
| `document_hash` | string | Yes | The unique identifier (hash) of the document or template to delete. |

#### 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 Bulk Jobs List

**Slug:** `EVERSIGN_GET_BULK_JOBS_LIST`

Tool to retrieve a list of bulk jobs for a business. Use when you need to view or paginate existing bulk jobs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of bulk jobs to return (default 100, range 1-1000) |
| `offset` | integer | No | Number of bulk jobs to skip (default 0) |

#### 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 Bulk Job Status

**Slug:** `EVERSIGN_GET_BULK_JOB_STATUS`

Tool to retrieve the status of a bulk job. Use when you need to check the progress of a bulk sending job, including counts of completed, cancelled, and in-progress documents.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bulk_job_id` | integer | Yes | ID of the bulk job to retrieve status for |

#### 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 Businesses

**Slug:** `EVERSIGN_LIST_BUSINESSES`

Retrieves all businesses associated with your Eversign account, or filters to a specific business if business_id is provided. This is a read-only operation that returns business details including ID, name, status, and whether it's the primary business. Use this action when you need to discover available businesses before performing operations that require a business context, or to verify business access permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `business_id` | integer | No | Optional business ID to filter results to a specific business. When provided, only returns the business with this ID if you have access to it. If not provided, returns all businesses associated with your account. |

#### 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 Documents

**Slug:** `EVERSIGN_LIST_DOCUMENTS`

Retrieves a paginated list of documents from your Eversign business account. This tool returns comprehensive document details including signers, status, timestamps, and metadata. Use filters to narrow results by status type, date range, search terms, or signer email. Perfect for monitoring document workflows, tracking signing progress, and building document dashboards.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results (starts at 1). Use with per_page to navigate through large document lists. |
| `type` | string ("all" | "my_action_required" | "waiting_for_others" | "completed" | "drafts" | "cancelled") | No | Filter documents by status type. Options: 'all' (default - all documents), 'my_action_required' (documents requiring your action), 'waiting_for_others' (documents waiting for other signers), 'completed' (signed documents), 'drafts' (draft documents), 'cancelled' (cancelled documents). |
| `query` | string | No | Search documents by text contained in document title, message, or other fields. Case-insensitive partial match. |
| `to_date` | string | No | Filter documents created on or before this date. Format: YYYY-MM-DD (e.g., '2024-12-31'). Combine with from_date for date range filtering. |
| `per_page` | integer | No | Number of documents to return per page (default: 50). Use lower values for faster responses or higher values (up to API limit) to reduce pagination. |
| `from_date` | string | No | Filter documents created on or after this date. Format: YYYY-MM-DD (e.g., '2024-01-15'). Useful for retrieving documents from a specific time period. |
| `signer_email` | string | No | Filter documents where the specified email address is a signer. Use to find all documents involving a particular person. |

#### 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:** `EVERSIGN_LIST_TEMPLATES`

Tool to list templates for a business with optional pagination. Use when you need to retrieve a paginated list of templates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for paginated results; must be at least 1 |
| `type` | string | No | Type of templates to retrieve: 'templates' (active templates), 'templates_archived' (archived templates), or 'template_drafts' (draft templates) |
| `limit` | integer | No | Number of results per page; must be between 1 and 500 |

#### 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 |

### Reassign Signer

**Slug:** `EVERSIGN_REASSIGN_SIGNER`

Tool to reassign a signer to a new person. Use when you need to replace an existing signer on a document before signing is complete. Example: "Reassign the signer alice@example.com on document abc123 to bob@example.com".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `reason` | string | No | Optional explanation for the reassignment |
| `signer_id` | integer | Yes | The ID of the signer which should be reassigned/replaced (found in document signer details) |
| `document_hash` | string | Yes | The unique hash (ID) of the document for which the signer should be changed |
| `new_signer_name` | string | Yes | The name of the new signer |
| `new_signer_email` | string | Yes | The email address of the new signer |

#### 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 |