Add signer to contract

POST /api/v1/contracts/{contractId}/signers: Add signer to contract. API keys and OAuth tokens need scope contracts:write. Parameters, responses and code samples.

Authorization

AuthorizationBearer <token>

API key cl_live_… or OAuth access token eco_at_… in Authorization: Bearer. Public operations (x-econtract-auth: public) need no credential.

In: header

Path Parameters

contractId*string

Header Parameters

Idempotency-Key?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

signerType?string

internal = workspace user, external = anyone by email (default external)

Value in"internal" | "external"

signerId?string

Tenant user id (required for internal signers)

externalSignerId?string

External signer (address book) id

email?string

Signer email (required)

name?string

signOrder?number

Position in sequential signing (1-based)

metadata?

Response Body

curl -X POST "https://api.econtract.online/api/v1/contracts/string/signers" \  -H "Content-Type: application/json" \  -d '{}'

Empty

Code Examples

curl -X POST "https://api.econtract.online/api/v1/contracts/ctr_abc123/signers" \
  -H "Authorization: Bearer cl_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "signerType": "internal",
    "signerId": "abc123",
    "externalSignerId": "abc123",
    "email": "[email protected]",
    "name": "Tran Thi B",
    "signOrder": 1,
    "metadata": {}
  }'

const res = await fetch("https://api.econtract.online/api/v1/contracts/ctr_abc123/signers", {
  method: "POST",
  headers: {
    "Authorization": "Bearer cl_live_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
      "signerType": "internal",
      "signerId": "abc123",
      "externalSignerId": "abc123",
      "email": "[email protected]",
      "name": "Tran Thi B",
      "signOrder": 1,
      "metadata": {}
  }),
}).then(r => r.json());

console.log(res);

import requests

res = requests.post(
    "https://api.econtract.online/api/v1/contracts/ctr_abc123/signers",
    headers={"Authorization": "Bearer cl_live_your_key_here"},
    json={
    "signerType": "internal",
    "signerId": "abc123",
    "externalSignerId": "abc123",
    "email": "[email protected]",
    "name": "Tran Thi B",
    "signOrder": 1,
    "metadata": {},
},
).json()

print(res)

package main

import (
    "fmt"
    "io"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    payload, _ := json.Marshal(map[string]interface{}{
        "signerType": "internal",
        "signerId": "abc123",
        "externalSignerId": "abc123",
        "email": "[email protected]",
        "name": "Tran Thi B",
        "signOrder": 1,
        "metadata": {},
    })

    req, _ := http.NewRequest("POST", "https://api.econtract.online/api/v1/contracts/ctr_abc123/signers", bytes.NewBuffer(payload))
    req.Header.Set("Authorization", "Bearer cl_live_your_key_here")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.econtract.online/api/v1/contracts/ctr_abc123/signers");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer cl_live_your_key_here",
    "Content-Type: application/json",
]);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'signerType' => 'internal',
    'signerId' => 'abc123',
    'externalSignerId' => 'abc123',
    'email' => '[email protected]',
    'name' => 'Tran Thi B',
    'signOrder' => 1,
    'metadata' => [
,
    ],
]));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String jsonBody = "{\"signerType\":\"internal\",\"signerId\":\"abc123\",\"externalSignerId\":\"abc123\",\"email\":\"[email protected]\",\"name\":\"Tran Thi B\",\"signOrder\":1,\"metadata\":{}}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.econtract.online/api/v1/contracts/ctr_abc123/signers"))
    .header("Authorization", "Bearer cl_live_your_key_here")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(jsonBody))
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer cl_live_your_key_here");

var json = @"{
  ""signerType"": ""internal"",
  ""signerId"": ""abc123"",
  ""externalSignerId"": ""abc123"",
  ""email"": ""[email protected]"",
  ""name"": ""Tran Thi B"",
  ""signOrder"": 1,
  ""metadata"": {}
}";
var content = new StringContent(json, System.Text.Encoding.UTF8, "application/json");

var response = await client.PostAsync("https://api.econtract.online/api/v1/contracts/ctr_abc123/signers", content);
var body = await response.Content.ReadAsStringAsync();

Console.WriteLine(body);