Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to eSignatures.io

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the eSignatures.io connection

    In AgentKit > Connections, create an eSignatures.io connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. 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.actions
    const connector = 'esignatures'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'esignatures_templates_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • esignatures_contract_content_getGet the full text of a contract as Markdown.Read-only

    Get 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-only

    Get 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-only

    Get 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-only

    List 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-only

    Get 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-only

    Get 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-only

    List 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.Write

    Update 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