conecto. Get started
E-signature

Send a template for signature

esign_send_template · Changes data · Markdown

Sends a saved template to new signers, one per role: one request, or up to 50 at once.

$0.50 per request sent

From your agent’s balance. A call that fails costs nothing.

An example

Send the trade account agreement to Mark Jansen at Restaurant Kranich, with Henrik countersigning.

Your agent callsesign_send_template$0.50 per request sent

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "template": "trade-account-agreement",
  "signers": [
    {
      "name": "Mark Jansen",
      "email": "mark.jansen@restaurant-kranich.example"
    },
    {
      "name": "Henrik Voss",
      "email": "henrik.voss@hansenvoss.example"
    }
  ]
}
What comes back
{
  "requests": [
    {
      "request_id": "5a8c5cf8-ecab-4bf2-9137-425fb063a9b0",
      "title": "Trade account agreement",
      "status": "sent",
      "order": "parallel",
      "sent_at": "2026-10-14T08:00:00+00:00",
      "expires_at": "2026-11-13T08:00:00+00:00",
      "completed_at": null,
      "document_file_id": "9e658977-9e28-4f74-b8d6-b50e075abca4",
      "signers": [
        {
          "position": 1,
          "name": "Mark Jansen",
          "email": "mark.jansen@restaurant-kranich.example",
          "status": "pending",
          "viewed_at": null,
          "signed_at": null,
          "decline_reason": null,
          "signing_url": "https://cncto.co/sign/MQ:1xHMcn:ks1ecMwFIQebt1NICImLjG_mAlwcBSEzBq0kDeeQEd0"
        },
        {
          "position": 2,
          "name": "Henrik Voss",
          "email": "henrik.voss@hansenvoss.example",
          "status": "pending",
          "viewed_at": null,
          "signed_at": null,
          "decline_reason": null,
          "signing_url": "https://cncto.co/sign/Mg:1xHMcn:4TNIxpu8-FgQAtT9RKg-2khJLDzqJnL49Qnqj5QUS5k"
        }
      ]
    }
  ]
}

Use it when

The same agreement goes to a new customer, or to every new contractor this month.

What it does

Send a saved template to new signers, one per role in the template's order: signers for one request, or sets for up to 50 at once (one request each, e.g. the same NDA to every new contractor). Each works like esign_send: emails, links, the signed PDF with its certificate. Emailing people outside the business needs an account that has topped up once. $0.50 per request sent.

What comes back

requests: each request sent, with its signers, their status and signing links. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
templateRequiredstringThe template's name, like service-agreement. 2 to 60 characters, matches ^[a-z0-9][a-z0-9-]*[a-z0-9]$.
signersarray of objects1 to 10 items.
signers[].nameRequiredstringUp to 120 characters.
signers[].emailRequiredstringUp to 254 characters.
setsarray of arraysSeveral requests at once: each set is one request's signers. 1 to 50 items.
titlestringInstead of the template's title. Up to 200 characters.
messagestringInstead of the template's note. Up to 2,000 characters.
expires_in_daysinteger1 to 90.

The call

Over MCP, call esign_send_template on https://api.conecto.chat/mcp/esign. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/esign_send_template \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template":"trade-account-agreement","signers":[{"name":"Mark Jansen","email":"mark.jansen@restaurant-kranich.example"},{"name":"Henrik Voss","email":"henrik.voss@hansenvoss.example"}]}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No template has that name.Call esign_list_templates for the names.
invalid_input400Neither or both of signers and sets were given, or a set does not have one signer per role.Give one signer per role, in the roles' order.
payment_required_for_outbound402The balance is still free credit, which sends only to the owner.Top up once (POST /v1/topups).
not_found404The template's PDF was deleted from the file store.Save the template again.

More E-signature tools

All 10 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md