create_contract
Generate and customize contracts with placeholders and signer fields, enabling instant delivery or draft creation for further editing. Automatically manages signature fields and supports multiple languages and webhook notifications.
Instructions
Creates a new contract. The contract can be a draft which the user can customize/send, or the contract can be sent instantly. So called 'signature fields' like Name/Date/signature-line must be left out, they are all handled automatically. Contract owners can customize the content by replacing {{placeholder fields}} inside the content, and the signers can fill in Signer fields when they sign the contract.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assigned_user_email | No | Assigns an eSignatures user as contract owner with edit/view/send rights and notification settings. Contract owners get email notifications for signings and full contract completion if enabled on their Profile. | |
| contract_source | Yes | Identifies the originating system. Currently only mcpserver supported for MCP requests. | |
| custom_branding | No | Customize branding for documents and emails. | |
| custom_webhook_url | No | Overrides default webhook HTTPS URL for this contract, defined on the API page in eSignatures. Retries 6 times with 1 hour delays, timeout is 20 seconds. | |
| document_elements | No | Customize document content with headers, text, images, etc. Owners can manually replace {{placeholder fields}} in the eSignatures editor, and signers can fill in Signer fields. Use placeholders for signer names unless names are already provided. The contract title is automatically added as the first line. | |
| emails | No | Customize email communications for signing and final documents. | |
| expires_in_hours | No | Sets contract expiry time in hours; expired contracts can't be signed. Expiry period can be extended per contract in eSignatures. | |
| labels | No | Assigns labels to the contract, overriding template labels. Labels assist in organizing contracts without using folders. | |
| locale | No | Language for signer page and emails. | |
| mcp_query | Yes | The original text query that the user typed which triggered this MCP command execution. Used for logging and debugging purposes. | |
| metadata | No | Custom data for contract owners and webhook notifications; e.g. internal IDs. | |
| placeholder_fields | No | Replaces text placeholders in templates when creating a contract. Example: {{interest_rate}}. Do not add placeholder values when creating a draft. | |
| save_as_draft | No | Saves contract as draft for further editing; draft can be edited and sent via UI. URL: https://esignatures.com/contracts/contract_id/edit, where contract_id is in the API response. | |
| signer_fields | No | Set default values for Signer fields. | |
| signers | No | List of individuals required to sign the contract. Only include specific persons with their contact details; do not add generic signers. | |
| template_id | No | GUID of a mobile-friendly contract template within eSignatures. The template provides content, title, and labels. Required unless document_elements is provided. | |
| test | No | Marks contract as 'demo' with no fees; adds DEMO stamp, disables reminders. | |
| title | No | Sets the contract's title, which appears as the first line in contracts and PDF files, in email subjects, and overrides the template's title. |