תיעוד ה-API

curl "https://sign.easy2sign.co.il/api/v1/templates?limit=5" \
  -H "Authorization: Bearer $E2S_API_KEY"

{
  "error": {
    "code": "send_blocked",
    "message": "לחותם \"העובד\" חסר מספר נייד — אליו נשלחים הקישור וקוד האימות",
    "messageEn": "A signer cannot be reached (needs a valid mobile, or an email when email delivery is enabled)",
    "problem": "no_phone",
    "role": "העובד"
  }
}

curl "https://sign.easy2sign.co.il/api/v1/templates" \
  -H "Authorization: Bearer $E2S_API_KEY"

{
  "object": "list",
  "data": [
    {
      "object": "template",
      "id": "cm2tpl7w0000a1b2c3d4e5f6g",
      "title": "הסכם עבודה שעתי",
      "description": "הסכם העסקה לעובד שעתי",
      "version": 3,
      "signingMode": "SERIAL",
      "signers": [
        {
          "role": "העובד",
          "order": 1
        }
      ],
      "variables": [
        {
          "key": "employee_name",
          "label": "שם העובד",
          "type": "person_name",
          "required": true,
          "options": [],
          "default": null,
          "unit": null
        },
        {
          "key": "hourly_wage",
          "label": "שכר לשעה",
          "type": "money",
          "required": true,
          "options": [],
          "default": null,
          "unit": "₪ לשעה"
        },
        {
          "key": "start_date",
          "label": "תאריך תחילת עבודה",
          "type": "date",
          "required": true,
          "options": [],
          "default": null,
          "unit": null
        },
        {
          "key": "position",
          "label": "תפקיד",
          "type": "choice",
          "required": false,
          "options": [
            "מלצר",
            "טבח",
            "אחמ״ש"
          ],
          "default": "מלצר",
          "unit": null
        }
      ],
      "fieldCount": 9,
      "ready": true,
      "warnings": [],
      "createdAt": "2026-09-01T08:12:44.120Z",
      "updatedAt": "2026-10-02T11:03:10.551Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

curl "https://sign.easy2sign.co.il/api/v1/templates/cm2tpl7w0000a1b2c3d4e5f6g" \
  -H "Authorization: Bearer $E2S_API_KEY"

{
  "object": "template",
  "id": "cm2tpl7w0000a1b2c3d4e5f6g",
  "title": "הסכם עבודה שעתי",
  "description": "הסכם העסקה לעובד שעתי",
  "version": 3,
  "signingMode": "SERIAL",
  "signers": [
    {
      "role": "העובד",
      "order": 1
    }
  ],
  "variables": [
    {
      "key": "employee_name",
      "label": "שם העובד",
      "type": "person_name",
      "required": true,
      "options": [],
      "default": null,
      "unit": null
    },
    {
      "key": "hourly_wage",
      "label": "שכר לשעה",
      "type": "money",
      "required": true,
      "options": [],
      "default": null,
      "unit": "₪ לשעה"
    },
    {
      "key": "start_date",
      "label": "תאריך תחילת עבודה",
      "type": "date",
      "required": true,
      "options": [],
      "default": null,
      "unit": null
    },
    {
      "key": "position",
      "label": "תפקיד",
      "type": "choice",
      "required": false,
      "options": [
        "מלצר",
        "טבח",
        "אחמ״ש"
      ],
      "default": "מלצר",
      "unit": null
    }
  ],
  "fieldCount": 9,
  "ready": true,
  "warnings": [],
  "createdAt": "2026-09-01T08:12:44.120Z",
  "updatedAt": "2026-10-02T11:03:10.551Z",
  "fields": [
    {
      "id": "cm2fld…01",
      "label": "שכר לשעה",
      "type": "TEXT",
      "page": 1,
      "required": true,
      "filledBy": "sender",
      "role": null,
      "variableKey": "hourly_wage"
    },
    {
      "id": "cm2fld…03",
      "label": "חתימת העובד",
      "type": "SIGNATURE",
      "page": 2,
      "required": true,
      "filledBy": "signer",
      "role": "העובד",
      "variableKey": null
    }
  ]
}

curl -X POST "https://sign.easy2sign.co.il/api/v1/documents" \
  -H "Authorization: Bearer $E2S_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "templateId": "cm2tpl7w0000a1b2c3d4e5f6g",
  "title": "הסכם עבודה – יוסי לוי",
  "signers": [
    {
      "role": "העובד",
      "name": "יוסי לוי",
      "phone": "050-1234567",
      "email": "yossi@example.com"
    }
  ],
  "values": {
    "employee_name": "יוסי לוי",
    "hourly_wage": 50,
    "start_date": "2026-11-01"
  },
  "send": true,
  "expiresAt": "2026-11-15T21:59:00Z"
}'

{
  "object": "document",
  "id": "cm2doc4k20003h7j9m1n2p3q4",
  "title": "הסכם עבודה – יוסי לוי",
  "status": "SENT",
  "signingMode": "SERIAL",
  "createdVia": "API",
  "expiresAt": "2026-11-15T21:59:00.000Z",
  "completedAt": null,
  "createdAt": "2026-10-18T09:30:00.000Z",
  "updatedAt": "2026-10-18T09:30:02.000Z",
  "signers": [
    {
      "id": "cm2sgn8r50005x6y7z8a9b0c1",
      "role": "העובד",
      "name": "יוסי לוי",
      "email": "yossi@example.com",
      "phone": "050-123-4567",
      "order": 1,
      "status": "PENDING",
      "viewedAt": null,
      "signedAt": null,
      "declinedAt": null,
      "signingUrl": "https://sign.easy2sign.co.il/sign/9QwX…"
    }
  ],
  "templateId": "cm2tpl7w0000a1b2c3d4e5f6g",
  "templateVersion": 3,
  "sentAt": "2026-10-18T09:30:02.000Z",
  "voidedAt": null,
  "voidReason": null,
  "values": {
    "employee_name": "יוסי לוי",
    "hourly_wage": "50",
    "start_date": "2026-11-01",
    "position": "מלצר"
  },
  "signedPdf": {
    "available": false,
    "sha256": null,
    "sealedAt": null
  },
  "warnings": []
}

curl "https://sign.easy2sign.co.il/api/v1/documents?status=COMPLETED&limit=50" \
  -H "Authorization: Bearer $E2S_API_KEY"

{
  "object": "list",
  "data": [
    {
      "object": "document",
      "id": "cm2doc4k20003h7j9m1n2p3q4",
      "title": "הסכם עבודה – יוסי לוי",
      "status": "COMPLETED",
      "signingMode": "SERIAL",
      "createdVia": "API",
      "expiresAt": null,
      "completedAt": "2026-10-18T12:41:11.000Z",
      "createdAt": "2026-10-18T09:30:00.000Z",
      "updatedAt": "2026-10-18T12:41:11.000Z",
      "signers": [
        {
          "id": "cm2sgn8r50005x6y7z8a9b0c1",
          "role": "העובד",
          "name": "יוסי לוי",
          "email": "yossi@example.com",
          "phone": "050-123-4567",
          "order": 1,
          "status": "SIGNED",
          "viewedAt": null,
          "signedAt": "2026-10-18T12:41:08.000Z",
          "declinedAt": null
        }
      ]
    }
  ],
  "hasMore": true,
  "nextCursor": "cm2doc4k20003h7j9m1n2p3q4"
}

curl "https://sign.easy2sign.co.il/api/v1/documents/cm2doc4k20003h7j9m1n2p3q4" \
  -H "Authorization: Bearer $E2S_API_KEY"

{
  "object": "document",
  "id": "cm2doc4k20003h7j9m1n2p3q4",
  "title": "הסכם עבודה – יוסי לוי",
  "status": "COMPLETED",
  "signingMode": "SERIAL",
  "createdVia": "API",
  "expiresAt": "2026-11-15T21:59:00.000Z",
  "completedAt": "2026-10-18T12:41:09.000Z",
  "createdAt": "2026-10-18T09:30:00.000Z",
  "updatedAt": "2026-10-18T09:30:02.000Z",
  "signers": [
    {
      "id": "cm2sgn8r50005x6y7z8a9b0c1",
      "role": "העובד",
      "name": "יוסי לוי",
      "email": "yossi@example.com",
      "phone": "050-123-4567",
      "order": 1,
      "status": "SIGNED",
      "viewedAt": "2026-10-18T10:02:51.000Z",
      "signedAt": "2026-10-18T12:41:08.000Z",
      "declinedAt": null
    }
  ],
  "templateId": "cm2tpl7w0000a1b2c3d4e5f6g",
  "templateVersion": 3,
  "sentAt": "2026-10-18T09:30:02.000Z",
  "voidedAt": null,
  "voidReason": null,
  "values": {
    "employee_name": "יוסי לוי",
    "hourly_wage": "50",
    "start_date": "2026-11-01",
    "position": "מלצר"
  },
  "signedPdf": {
    "available": true,
    "sha256": "4f9c1e…b72a",
    "sealedAt": "2026-10-18T12:41:11.000Z"
  },
  "fields": [
    {
      "id": "cm2fld…01",
      "label": "שכר לשעה",
      "type": "TEXT",
      "page": 1,
      "signerId": null,
      "role": null,
      "variableKey": "hourly_wage",
      "value": "50 ₪ לשעה"
    },
    {
      "id": "cm2fld…02",
      "label": "מספר תעודת זהות",
      "type": "TEXT",
      "page": 2,
      "signerId": "cm2sgn8r50005x6y7z8a9b0c1",
      "role": "העובד",
      "variableKey": null,
      "value": "123456782"
    },
    {
      "id": "cm2fld…03",
      "label": "חתימת העובד",
      "type": "SIGNATURE",
      "page": 2,
      "signerId": "cm2sgn8r50005x6y7z8a9b0c1",
      "role": "העובד",
      "variableKey": null,
      "value": "[signed]"
    }
  ]
}

curl -X POST "https://sign.easy2sign.co.il/api/v1/documents/cm2doc4k20003h7j9m1n2p3q4/send" \
  -H "Authorization: Bearer $E2S_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "object": "document",
  "id": "cm2doc4k20003h7j9m1n2p3q4",
  "title": "הסכם עבודה – יוסי לוי",
  "status": "SENT",
  "signingMode": "SERIAL",
  "createdVia": "API",
  "expiresAt": "2026-11-15T21:59:00.000Z",
  "completedAt": null,
  "createdAt": "2026-10-18T09:30:00.000Z",
  "updatedAt": "2026-10-18T09:30:02.000Z",
  "signers": [
    {
      "id": "cm2sgn8r50005x6y7z8a9b0c1",
      "role": "העובד",
      "name": "יוסי לוי",
      "email": "yossi@example.com",
      "phone": "050-123-4567",
      "order": 1,
      "status": "PENDING",
      "viewedAt": null,
      "signedAt": null,
      "declinedAt": null,
      "signingUrl": "https://sign.easy2sign.co.il/sign/9QwX…",
      "delivery": "whatsapp"
    }
  ],
  "templateId": "cm2tpl7w0000a1b2c3d4e5f6g",
  "templateVersion": 3,
  "sentAt": "2026-10-18T09:30:02.000Z",
  "voidedAt": null,
  "voidReason": null,
  "values": {
    "employee_name": "יוסי לוי",
    "hourly_wage": "50",
    "start_date": "2026-11-01",
    "position": "מלצר"
  },
  "signedPdf": {
    "available": false,
    "sha256": null,
    "sealedAt": null
  }
}

curl -X POST "https://sign.easy2sign.co.il/api/v1/documents/cm2doc4k20003h7j9m1n2p3q4/remind" \
  -H "Authorization: Bearer $E2S_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "object": "reminder",
  "documentId": "cm2doc4k20003h7j9m1n2p3q4",
  "results": [
    {
      "signerId": "cm2sgn8r50005x6y7z8a9b0c1",
      "role": "העובד",
      "delivery": "whatsapp"
    }
  ]
}

curl -X POST "https://sign.easy2sign.co.il/api/v1/documents/cm2doc4k20003h7j9m1n2p3q4/void" \
  -H "Authorization: Bearer $E2S_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "reason": "העסקה בוטלה"
}'

{
  "object": "document",
  "id": "cm2doc4k20003h7j9m1n2p3q4",
  "title": "הסכם עבודה – יוסי לוי",
  "status": "VOIDED",
  "signingMode": "SERIAL",
  "createdVia": "API",
  "expiresAt": "2026-11-15T21:59:00.000Z",
  "completedAt": null,
  "createdAt": "2026-10-18T09:30:00.000Z",
  "updatedAt": "2026-10-18T09:30:02.000Z",
  "signers": [
    {
      "id": "cm2sgn8r50005x6y7z8a9b0c1",
      "role": "העובד",
      "name": "יוסי לוי",
      "email": "yossi@example.com",
      "phone": "050-123-4567",
      "order": 1,
      "status": "PENDING",
      "viewedAt": null,
      "signedAt": null,
      "declinedAt": null
    }
  ],
  "templateId": "cm2tpl7w0000a1b2c3d4e5f6g",
  "templateVersion": 3,
  "sentAt": "2026-10-18T09:30:02.000Z",
  "voidedAt": "2026-10-19T07:15:00.000Z",
  "voidReason": "העסקה בוטלה",
  "values": {
    "employee_name": "יוסי לוי",
    "hourly_wage": "50",
    "start_date": "2026-11-01",
    "position": "מלצר"
  },
  "signedPdf": {
    "available": false,
    "sha256": null,
    "sealedAt": null
  }
}

curl "https://sign.easy2sign.co.il/api/v1/documents/cm2doc4k20003h7j9m1n2p3q4/signed" \
  -H "Authorization: Bearer $E2S_API_KEY"

{
  "object": "signed_pdf",
  "documentId": "cm2doc4k20003h7j9m1n2p3q4",
  "url": "https://…supabase.co/storage/v1/object/sign/documents/…/signed.pdf?token=…",
  "expiresAt": "2026-10-18T12:50:00.000Z",
  "sha256": "4f9c1e…b72a",
  "sealedAt": "2026-10-18T12:41:11.000Z"
}

curl "https://sign.easy2sign.co.il/api/v1/documents/cm2doc4k20003h7j9m1n2p3q4/audit" \
  -H "Authorization: Bearer $E2S_API_KEY"

{
  "object": "audit_trail",
  "documentId": "cm2doc4k20003h7j9m1n2p3q4",
  "integrity": {
    "valid": true,
    "total": 6,
    "brokenAt": null
  },
  "events": [
    {
      "id": "cm2aud…01",
      "action": "CREATED",
      "at": "2026-10-18T09:30:00.000Z",
      "signerId": null,
      "role": null,
      "ip": "203.0.113.7",
      "userAgent": "node",
      "metadata": {
        "via": "template",
        "channel": "api",
        "templateId": "cm2tpl7w0000a1b2c3d4e5f6g"
      },
      "hash": "a1c3…"
    },
    {
      "id": "cm2aud…02",
      "action": "SENT",
      "at": "2026-10-18T09:30:02.000Z",
      "signerId": "cm2sgn8r50005x6y7z8a9b0c1",
      "role": "העובד",
      "ip": "203.0.113.7",
      "userAgent": "node",
      "metadata": {
        "roleName": "העובד",
        "channel": "api"
      },
      "hash": "9be0…"
    },
    {
      "id": "cm2aud…05",
      "action": "SIGNED",
      "at": "2026-10-18T12:41:08.000Z",
      "signerId": "cm2sgn8r50005x6y7z8a9b0c1",
      "role": "העובד",
      "ip": "198.51.100.23",
      "userAgent": "Mozilla/5.0 …",
      "metadata": {},
      "hash": "77d2…"
    }
  ]
}

curl -X POST "https://sign.easy2sign.co.il/api/v1/fill" \
  -H "Authorization: Bearer $E2S_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "text": "הסכם עבודה ליוסי לוי, 50 ש״ח לשעה, מתחיל ב-1.11, נייד 050-1234567"
}'

{
  "object": "fill_session",
  "id": "cm2fil3d90002q4w6e8r0t2y4",
  "status": "READY",
  "mode": "TEMPLATE",
  "template": {
    "id": "cm2tpl7w0000a1b2c3d4e5f6g",
    "title": "הסכם עבודה שעתי"
  },
  "templateOptions": [],
  "values": [
    {
      "key": "employee_name",
      "label": "שם העובד",
      "valueType": "person_name",
      "value": "יוסי לוי",
      "display": "יוסי לוי",
      "inferred": false,
      "required": true
    },
    {
      "key": "hourly_wage",
      "label": "שכר לשעה",
      "valueType": "money",
      "value": "50",
      "display": "50 ₪ לשעה",
      "inferred": false,
      "required": true
    },
    {
      "key": "start_date",
      "label": "תאריך תחילת עבודה",
      "valueType": "date",
      "value": "2026-11-01",
      "display": "01.11.2026",
      "inferred": true,
      "required": true
    }
  ],
  "missing": [],
  "signer": {
    "name": "יוסי לוי",
    "phone": "972501234567",
    "email": null
  },
  "documentId": "cm2doc4k20003h7j9m1n2p3q4",
  "replyText": "הכנתי את הסכם העבודה ליוסי לוי. לשלוח לחתימה?",
  "warnings": [
    "החותם נקבע לפי השם שבמסמך: יוסי לוי."
  ]
}

curl "https://sign.easy2sign.co.il/api/v1/fill/cm2fil3d90002q4w6e8r0t2y4" \
  -H "Authorization: Bearer $E2S_API_KEY"

curl -X POST "https://sign.easy2sign.co.il/api/v1/fill/cm2fil3d90002q4w6e8r0t2y4/messages" \
  -H "Authorization: Bearer $E2S_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "text": "השכר 55 ש״ח לשעה"
}'

curl -X POST "https://sign.easy2sign.co.il/api/v1/fill/cm2fil3d90002q4w6e8r0t2y4/confirm" \
  -H "Authorization: Bearer $E2S_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

{
  "object": "fill_confirmation",
  "documentId": "cm2doc4k20003h7j9m1n2p3q4",
  "whatsapp": true,
  "links": [
    {
      "signerId": "cm2sgn8r50005x6y7z8a9b0c1",
      "roleName": "העובד",
      "url": "https://sign.easy2sign.co.il/sign/9QwX…",
      "delivery": "whatsapp",
      "hasPhone": true,
      "signed": false
    }
  ],
  "session": {
    "object": "fill_session",
    "id": "cm2fil3d90002q4w6e8r0t2y4",
    "status": "SENT",
    "mode": "TEMPLATE",
    "template": {
      "id": "cm2tpl7w0000a1b2c3d4e5f6g",
      "title": "הסכם עבודה שעתי"
    },
    "templateOptions": [],
    "values": [
      {
        "key": "employee_name",
        "label": "שם העובד",
        "valueType": "person_name",
        "value": "יוסי לוי",
        "display": "יוסי לוי",
        "inferred": false,
        "required": true
      },
      {
        "key": "hourly_wage",
        "label": "שכר לשעה",
        "valueType": "money",
        "value": "50",
        "display": "50 ₪ לשעה",
        "inferred": false,
        "required": true
      },
      {
        "key": "start_date",
        "label": "תאריך תחילת עבודה",
        "valueType": "date",
        "value": "2026-11-01",
        "display": "01.11.2026",
        "inferred": true,
        "required": true
      }
    ],
    "missing": [],
    "signer": {
      "name": "יוסי לוי",
      "phone": "972501234567",
      "email": null
    },
    "documentId": "cm2doc4k20003h7j9m1n2p3q4",
    "replyText": "המסמך נשלח לחתימה.",
    "warnings": [
      "החותם נקבע לפי השם שבמסמך: יוסי לוי."
    ]
  }
}

curl -X POST "https://sign.easy2sign.co.il/api/v1/fill/cm2fil3d90002q4w6e8r0t2y4/cancel" \
  -H "Authorization: Bearer $E2S_API_KEY"

Content-Type: application/json
X-Easy2Sign-Event: document.completed
X-Easy2Sign-Signature: 5d41402abc4b2a76b9719d911017c592…
X-Easy2Sign-Delivery: 0b6f3c1e-8f0a-4c55-9a77-3c1d2e4f5a6b
X-Easy2Sign-Timestamp: 1792312871

import crypto from "node:crypto";
import express from "express";

const app = express();
const SECRET = process.env.E2S_WEBHOOK_SECRET; // from /dashboard/developers
const seen = new Set(); // use your database in production

// The signature covers the RAW body: read it before any JSON parsing.
app.post("/webhooks/easy2sign", express.raw({ type: "application/json" }), (req, res) => {
  const signature = req.get("X-Easy2Sign-Signature") ?? "";
  const timestamp = Number(req.get("X-Easy2Sign-Timestamp"));

  const expected = crypto.createHmac("sha256", SECRET).update(req.body).digest("hex");
  const ok =
    signature.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(signature, "hex"), Buffer.from(expected, "hex"));
  if (!ok) return res.status(401).end();

  // Replay defence: reject old deliveries and duplicates.
  if (!timestamp || Math.abs(Date.now() / 1000 - timestamp) > 300) return res.status(400).end();
  const event = JSON.parse(req.body.toString("utf8"));
  if (seen.has(event.id)) return res.status(200).end();
  seen.add(event.id);

  if (event.event === "document.completed") {
    // e.g. fetch the signed PDF: GET /api/v1/documents/{id}/signed
    console.log("completed", event.data.documentId);
  }
  res.status(200).end(); // answer fast (5s timeout); do slow work async
});

curl "https://sign.easy2sign.co.il/api/v1/webhooks/events" \
  -H "Authorization: Bearer $E2S_API_KEY"

{
  "object": "list",
  "data": [
    {
      "object": "webhook_event_type",
      "type": "document.completed",
      "description": "כל החותמים חתמו; ה-PDF החתום נוצר מיד אחר כך",
      "descriptionEn": "Every signer signed; the sealed PDF is produced right after",
      "data": {
        "documentId": "string"
      }
    }
  ],
  "headers": {
    "event": "X-Easy2Sign-Event",
    "signature": "X-Easy2Sign-Signature",
    "delivery": "X-Easy2Sign-Delivery",
    "timestamp": "X-Easy2Sign-Timestamp"
  },
  "signature": {
    "algorithm": "HMAC-SHA256",
    "encoding": "hex",
    "signedContent": "raw request body"
  }
}