The eSignatures.io connector lets your AI agent act in each user's eSignatures.io account. Each user connects their own eSignatures.io API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 24 tools.
- Tools
- 24
- What they doRead · write · destructive
- 7 · 13 · 47 read13 write4 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the eSignatures.io connection
In AgentKit > Connections, create an eSignatures.io connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'esignatures'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize eSignatures.io:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'esignatures_templates_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "esignatures"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize eSignatures.io:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="esignatures_templates_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their eSignatures.io credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolesignatures_contract_content_getGet the full text of a contract as Markdown.Read-onlyGet Contract Content
Get the full text of a contract as Markdown. Returns the contract_id and markdown. Use this before esignatures_contract_content_update to find the exact text to edit.
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
esignatures_contract_getGet a contract's details, including its status, signers, their sign page URLs and the values they entered.Read-onlyGet Contract
Get a contract's details, including its status, signers, their sign page URLs and the values they entered. Returns the contract id, status, title, metadata, signers and, once signed, the PDF URL. Use this to check one contract. Avoid polling it repeatedly; eSignatures recommends webhooks, and contracts older than two weeks may return partial data.
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
esignatures_contract_placeholder_fields_getGet the placeholder values currently set on a contract.Read-onlyGet Contract Placeholder Fields
Get the placeholder values currently set on a contract. Returns placeholder_fields with each key and its replacement. Use this before esignatures_contract_placeholder_fields_update.
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
esignatures_template_collaborators_listList a template's collaborators.Read-onlyList Template Collaborators
List a template's collaborators. Returns each collaborator's id, name, email and editor URL. Use this to find a collaborator ID to remove.
Inputs
template_idstringrequired- Template ID, from esignatures_templates_list (also shown when editing the template). Example: 4templ44-8888.
esignatures_template_content_getGet a template's full text as Markdown.Read-onlyGet Template Content
Get a template's full text as Markdown. Returns template_id and markdown. Use this before esignatures_template_content_update.
Inputs
template_idstringrequired- Template ID, from esignatures_templates_list (also shown when editing the template). Example: 4templ44-8888.
esignatures_template_getGet a template's details.Read-onlyGet Template
Get a template's details. Returns template_id, title, created_at, its placeholder fields and signer field IDs. Use this to see which placeholder_fields a contract from it needs.
Inputs
template_idstringrequired- Template ID, from esignatures_templates_list (also shown when editing the template). Example: 4templ44-8888.
esignatures_templates_listList the templates in your eSignatures.io account.Read-onlyList Templates
List the templates in your eSignatures.io account. Returns each template's template_id and title. Use this to find the template for esignatures_contract_create. Use esignatures_template_get for its placeholders.
Inputs
This tool takes no inputs.
esignatures_contract_content_updateEdit an unsigned contract's text by find-and-replace on its Markdown.WriteUpdate Contract Content
Edit an unsigned contract's text by find-and-replace on its Markdown. Returns the result of the edits. Use esignatures_contract_content_get first to copy the exact text. Use dry_run=yes to check edits.
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
editsarrayrequired- Edits to apply in order. Each has find_markdown (existing text, matched literally) and replace_with_markdown (new Markdown; empty string removes the match). Example: [{"find_markdown": " including weekends.", "replace_with_markdown": " excluding weekends."}]
dry_runstring- yes to check the edits without saving them. Example: yes.one of
yesno
esignatures_contract_createCreate a contract from a template and, unless saved as a draft, send it to the signers for signature.WriteCreate Contract
Create a contract from a template and, unless saved as a draft, send it to the signers for signature. Returns the contract id, status and each signer's id and sign_page_url. Use test=yes while trying things out (no fees). Use esignatures_templates_list to find the template ID; set save_as_draft=yes and send later with esignatures_contract_draft_send.
Inputs
signersarrayrequired- People who sign. Each needs name and an email or mobile; optional company_name, signing_order, auto_sign (yes/no, only for your own signature), signature_request_delivery_methods, signed_document_delivery_method, multi_factor_authentications and redirect_url. Example: [{"name": "Sam Signer", "email": "sam@example.com"}]
template_idstringrequired- Template to build the contract from, from esignatures_templates_list. Example: 4templ44-8888.
assigned_user_emailstring- Email of a user in your eSignatures account who manages the contract and gets its notifications. Example: colleague@example.com.
custom_brandingobject- White-label sender: company_name and logo_url. Example: {"company_name": "WhiteLabel LLC", "logo_url": "https://example.com/logo.png"}
custom_webhook_urlstring- Webhook URL for this contract, overriding the one in your API settings. Example: https://example.com/esignatures-webhook.
emailsobject- Email customization: signature_request_subject, signature_request_text, final_contract_subject, final_contract_text (use __FULL_NAME__ for the signer's name), cc_email_addresses and reply_to. Example: {"signature_request_subject": "Your document is ready to sign"}
expires_in_hoursstring- Hours until the contract expires. Example: 48.
labelsarray- Labels to group and search contracts on the dashboard. Example: ["Rental"]
localestring- Language of the signer page and emails, for example en, en-GB, de, fr, es, nl or ja. Example: en.
metadatastring- Your own reference stored with the contract and echoed in webhooks. Example: ID0001.
placeholder_fieldsarray- Placeholder values. Each item has placeholder_key (the text between the double curly braces in the template, e.g. interest_rate) and one of replace_with_text, replace_with_markdown or replace_with_template (a template ID whose content is inserted). Example: [{"placeholder_key": "preferred_term", "replace_with_text": "24 months"}]
save_as_draftstring- yes saves it as a draft instead of sending it. Example: no.one of
yesno signer_fieldsarray- Default values for fields the signer fills in. Each has signer_field_id (from the template editor) and default_value (1 ticks a checkbox, YYYY-MM-DD for dates). Example: [{"signer_field_id": "preferred_term", "default_value": "15 years"}]
teststring- yes marks it as a free demo contract. Defaults to no. Example: yes.one of
yesno titlestring- Contract title shown in emails, documents and the dashboard. Defaults to the template title. Example: Loan Agreement - Saver package.
esignatures_contract_draft_sendSend a contract saved as a draft to its signers.WriteSend Draft Contract
Send a contract saved as a draft to its signers. Returns status queued. Use this only for contracts in draft status. esignatures_contract_create sends immediately unless save_as_draft is yes.
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
esignatures_contract_pdf_preview_generateStart generating a PDF preview of a contract.WriteGenerate Contract PDF Preview
Start generating a PDF preview of a contract. The PDF URL arrives later in a contract-pdf-generated webhook. Returns status queued. Use this to review a contract before or after sending.
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
esignatures_contract_placeholder_fields_updateChange placeholder values on an unsigned contract.WriteUpdate Contract Placeholder Fields
Change placeholder values on an unsigned contract. Only the fields sent are changed. Returns status updated. Use esignatures_contract_placeholder_fields_get to see current values.
- Idempotent
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
placeholder_fieldsarrayrequired- Placeholder values. Each item has placeholder_key (the text between the double curly braces in the template, e.g. interest_rate) and one of replace_with_text, replace_with_markdown or replace_with_template (a template ID whose content is inserted). Example: [{"placeholder_key": "package_name", "replace_with_text": "Premium"}]
esignatures_contract_signer_addAdd a signer to an existing contract.WriteAdd Contract Signer
Add a signer to an existing contract. The new signer is not emailed automatically. Returns status success. Use esignatures_contract_signer_request_resend to send them the request.
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
company_namestring- Signer's company name. Example: ACME Corp.
emailstring- Signer's email address. Email or mobile is needed to deliver the request. Example: sam@example.com.
mobilestring- Signer's mobile number. Non-US numbers start with the country code. Example: +12481234567.
multi_factor_authenticationsarray- Identity checks for the signer: sms_verification_code, email_verification_code and/or photo_id. Needs matching contact details. Example: ["email_verification_code"]
namestring- Signer's full name. Example: Sam Signer.
redirect_urlstring- URL the signer is sent to after signing. Example: https://example.com/thank-you.
signature_request_delivery_methodsarray- How to deliver the signature request: email and/or sms. An empty list skips sending. Calculated by default. Example: ["email"]
signed_document_delivery_methodstring- How to deliver the signed document: email or sms. Calculated by default; delivery is legally required in most regions. Example: email.one of
emailsms
esignatures_contract_signer_request_resendSend (or resend) the signature request to one signer.WriteResend Signature Request
Send (or resend) the signature request to one signer. Returns status queued. Use this after adding or updating a signer, or as a reminder.
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
signer_idstringrequired- Signer ID, from the signers list returned by esignatures_contract_get. Example: 6signer6-9999.
esignatures_contract_signer_updateUpdate a signer's contact details or delivery and verification settings.WriteUpdate Contract Signer
Update a signer's contact details or delivery and verification settings. The contract is not re-sent automatically. Returns status updated. Use esignatures_contract_signer_request_resend afterwards if needed.
- Idempotent
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
signer_idstringrequired- Signer ID, from the signers list returned by esignatures_contract_get. Example: 6signer6-9999.
company_namestring- Signer's company name. Example: ACME Corp.
emailstring- Signer's email address. Email or mobile is needed to deliver the request. Example: sam@example.com.
mobilestring- Signer's mobile number. Non-US numbers start with the country code. Example: +12481234567.
multi_factor_authenticationsarray- Identity checks for the signer: sms_verification_code, email_verification_code and/or photo_id. Needs matching contact details. Example: ["email_verification_code"]
namestring- Signer's full name. Example: Sam Signer.
redirect_urlstring- URL the signer is sent to after signing. Example: https://example.com/thank-you.
signature_request_delivery_methodsarray- How to deliver the signature request: email and/or sms. An empty list skips sending. Calculated by default. Example: ["email"]
signed_document_delivery_methodstring- How to deliver the signed document: email or sms. Calculated by default; delivery is legally required in most regions. Example: email.one of
emailsms
esignatures_template_collaborator_addGive someone a link to edit a template.WriteAdd Template Collaborator
Give someone a link to edit a template. When email is given, an invitation is emailed. Returns template_collaborator_id and template_collaborator_editor_url (embeddable with embedded=yes). Use esignatures_template_collaborator_remove to revoke access.
Inputs
template_idstringrequired- Template ID, from esignatures_templates_list (also shown when editing the template). Example: 4templ44-8888.
emailstring- Collaborator's email. An invitation is sent when provided. Example: chris@example.com.
namestring- Collaborator's name. Example: Chris Collaborator.
esignatures_template_content_updateEdit a template's text by find-and-replace on its Markdown.WriteUpdate Template Content
Edit a template's text by find-and-replace on its Markdown. Returns the result of the edits. Use esignatures_template_content_get first. Use dry_run=yes to check edits.
Inputs
editsarrayrequired- Edits to apply in order. Each has find_markdown (existing text, matched literally) and replace_with_markdown (new Markdown; empty string removes the match). Example: [{"find_markdown": " including weekends.", "replace_with_markdown": " excluding weekends."}]
template_idstringrequired- Template ID, from esignatures_templates_list (also shown when editing the template). Example: 4templ44-8888.
dry_runstring- yes to check the edits without saving them. Example: yes.one of
yesno
esignatures_template_createCreate a contract template from Markdown.WriteCreate Template
Create a contract template from Markdown. Returns the new template_id. Use double curly braces in the Markdown for placeholder fields, such as {{interest_rate}}. Use esignatures_template_duplicate to copy an existing one.
Inputs
markdownstringrequired- Template content in eSignatures' extended Markdown (placeholders in double curly braces; signer fields per the Markdown syntax docs). Example: ## Terms This agreement is between {{landlord_name}} and the tenant.
titlestringrequired- Template title. Example: Rental Agreement.
labelsarray- Labels applied to the template and its contracts. Example: ["Rental"]
esignatures_template_duplicateCopy a template under a new title, optionally filling some of its placeholders in the copy.WriteDuplicate Template
Copy a template under a new title, optionally filling some of its placeholders in the copy. Returns the new template's id. Use this to make customer-specific variants of a master template.
Inputs
template_idstringrequired- Template ID, from esignatures_templates_list (also shown when editing the template). Example: 4templ44-8888.
titlestringrequired- Title of the new template. Example: Rental Agreement - ACME.
placeholder_fieldsarray- Placeholder values. Each item has placeholder_key (the text between the double curly braces in the template, e.g. interest_rate) and one of replace_with_text, replace_with_markdown or replace_with_template (a template ID whose content is inserted). These are baked into the new template. Example: [{"placeholder_key": "business_name", "replace_with_text": "ACME Co"}]
esignatures_template_updateChange a template's title or labels.WriteUpdate Template
Change a template's title or labels. Returns the result. Use esignatures_template_content_update to change its text.
- Idempotent
Inputs
template_idstringrequired- Template ID, from esignatures_templates_list (also shown when editing the template). Example: 4templ44-8888.
labelsarray- Labels for the template and its contracts. Example: ["Rental"]
titlestring- New template title. Example: Rental Agreement v2.
esignatures_contract_signer_deleteRemove a signer from a contract.DestructiveDelete Contract Signer
Remove a signer from a contract. Returns status queued. Get signer IDs from esignatures_contract_get.
- Idempotent
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
signer_idstringrequired- Signer ID, from the signers list returned by esignatures_contract_get. Example: 6signer6-9999.
esignatures_contract_withdrawWithdraw a contract so it can no longer be signed.DestructiveWithdraw Contract
Withdraw a contract so it can no longer be signed. Signed contracts cannot be withdrawn; the details stay queryable. Returns status withdrawn. Use this to cancel a sent contract.
- Idempotent
Inputs
contract_idstringrequired- Contract ID, returned by eSignatures.io when the contract was created (also in webhook notifications). Example: 1contr11-2222.
esignatures_template_collaborator_removeRemove a collaborator's access to a template.DestructiveRemove Template Collaborator
Remove a collaborator's access to a template. Returns the result. Get collaborator IDs from esignatures_template_collaborators_list.
- Idempotent
Inputs
collaborator_idstringrequired- Template collaborator ID, from esignatures_template_collaborators_list. Example: 7collab7-1111.
template_idstringrequired- Template ID, from esignatures_templates_list (also shown when editing the template). Example: 4templ44-8888.
esignatures_template_deleteDelete a template.DestructiveDelete Template
Delete a template. Returns the result. Get template IDs from esignatures_templates_list.
- Idempotent
Inputs
template_idstringrequired- Template ID, from esignatures_templates_list (also shown when editing the template). Example: 4templ44-8888.
No tools match.