For developers

API Documentation

The Signeur REST API lets your application create signature requests, monitor their status, and download locked PDFs. This documentation describes endpoints implemented today.

Base URLhttps://signeur.eu
OpenAPI 3.1 spec

Authentication

All API calls require a Bearer token in the Authorization header. Tokens are hashed with SHA-256 and compared against the stored hash — plaintext is never persisted anywhere.

Example:

Authorization: Bearer sgn_live_xxx...

Obtain an API key from the service administrator. Key format is sgn_live_<random>.

Error responses

All errors are returned as JSON with error and message fields. HTTP status codes follow conventions.

{
  "error": "invalid_signer_email",
  "message": "Field 'signer_email' is missing or not a valid email."
}
CodeMeaning
400Bad request (validation failed)
401Authorization header missing or the Bearer token is invalid
404Resource not found or it belongs to another organization
409Conflict: the request is already signed / not yet signed
410Resource has expired (link older than 30 days)
429Too many requests — wait for the time given in the Retry-After header
500Server error (database, storage or email delivery failure)

Rate limits

Limits are enforced per API key: 10 requests per minute and 100 requests per day. Responses include X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers for the per-minute window. When a limit is exceeded the API returns 429 with a Retry-After header giving the wait time in seconds. Contact us if you need higher limits.

Idempotency

The `POST /v1/signatures` endpoint accepts an optional `Idempotency-Key` header (any unique string, typically a UUID). When you retry a request with the same key, Signeur replays the original response instead of creating a duplicate. Keys are scoped per API key owner and retained for 24 hours.

POST https://api.signeur.eu/v1/signatures
Authorization: Bearer sgn_live_...
Idempotency-Key: 0d8a2c41-7e3f-4b9d-bc59-2c5fd8a91f4d
Content-Type: application/json

{ … }

If you send the same key with a different request body, Signeur returns 409 idempotency_key_conflict; while the original request is still being processed, a concurrent retry returns 409 idempotency_key_in_progress with a Retry-After header. Replayed responses include an `Idempotent-Replayed: true` header so you can detect them client-side.

Endpoints

POST/v1/documents

Upload a PDF for a signature request

Uploads the PDF ahead of time and returns an upload id that you pass to POST /v1/signatures as document.upload_id. Two modes, chosen by Content-Type: send the PDF bytes directly (application/pdf, whole request at most 4.5 MB), or send a JSON body (application/json) to receive a pre-signed upload URL and PUT the file there yourself (up to 10 MB, no other headers than Content-Type needed). An upload that is not used within 24 hours is deleted, and one upload can be used for one request only.

FieldTypeRequiredDescription
size_bytesnumbernoOptional (mode B). Expected file size in bytes; the request is rejected immediately if it exceeds 10 MB.

PDF requirements: the file is checked on receipt. Encrypted or password-protected PDFs (pdf_encrypted), unreadable files (pdf_unreadable) and PDFs that already carry a digital signature (pdf_already_signed) are rejected with 400 before anything is charged. Form fields are flattened so that field values become fixed content; if flattening fails the request is rejected (pdf_form_flatten_failed). View-dependent or active content — optional content layers, hidden or print-only annotations, JavaScript and embedded files — is rejected (pdf_unsupported_content) so that the signer sees exactly what the sealed document shows.

Mode A — PDF bytes in the request body (max 4.5 MB):

curl -X POST https://api.signeur.eu/v1/documents \
  -H "Authorization: Bearer sgn_live_..." \
  -H "Content-Type: application/pdf" \
  --data-binary @contract.pdf

Response

{
  "id": "3f0e1c2a-8b1d-4f7e-9c21-5a6b7c8d9e0f",
  "size_bytes": 1834021,
  "expires_at": "2026-09-20T08:00:00.000Z"
}

Mode B — pre-signed upload URL (files up to 10 MB):

curl -X POST https://api.signeur.eu/v1/documents \
  -H "Authorization: Bearer sgn_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "size_bytes": 8123456 }'

Response

{
  "id": "3f0e1c2a-8b1d-4f7e-9c21-5a6b7c8d9e0f",
  "upload_url": "https://…/storage/v1/object/upload/sign/…?token=…",
  "upload_method": "PUT",
  "upload_headers": { "Content-Type": "application/pdf" },
  "upload_url_expires_at": "2026-09-19T10:00:00.000Z",
  "expires_at": "2026-09-20T08:00:00.000Z",
  "max_size_bytes": 10485760
}

Then PUT the file to upload_url (valid for 2 hours):

curl -X PUT "<upload_url>" \
  -H "Content-Type: application/pdf" \
  --data-binary @contract.pdf

Finally create the request with document.upload_id:

curl -X POST https://api.signeur.eu/v1/signatures \
  -H "Authorization: Bearer sgn_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Order Agreement #1234",
    "signers": [{ "email": "buyer@example.com", "name": "Anna Buyer" }],
    "document": {
      "filename": "contract.pdf",
      "upload_id": "3f0e1c2a-8b1d-4f7e-9c21-5a6b7c8d9e0f"
    }
  }'
POST/v1/signatures

Create a signature request

Creates a new signature request (1–20 signers), stores the PDF in Storage, and sends an invitation email to each signer.

FieldTypeRequiredDescription
titlestringyesTitle of the request (shown in the invitation email).
messagestringnoOptional message shown to each signer.
signers[]arrayyesArray of 1–20 signer objects. At least one is required.
signers[].emailstringyesThe signer's email address.
signers[].namestringnoThe signer's name (shown on the audit page).
signers[].localestringnoPer-signer email locale: 'en' | 'fi' | 'fr' | 'de'. Falls back to the top-level locale, then 'en'.
localestringnoDefault locale for signers that do not specify their own. Allowed values: 'en' | 'fi' | 'fr' | 'de'. If omitted, the organization's configured default invitation language is used; if that is not set either, 'en'.
reply_tostringnoOptional. Reply-To address for the invitation emails: a signer's reply is directed to this address. If omitted, the address configured in the organization settings is used; if neither is set, no Reply-To header is added.
document.filenamestringnoOptional. Original filename of the PDF.
document.content_base64stringnoPDF content as a base64-encoded string (max 10 MB decoded). The whole HTTP request is limited to 4.5 MB, so base64 works for PDFs up to about 3 MB — for larger files upload the PDF first with POST /v1/documents and pass document.upload_id.
document.upload_idstringnoId returned by POST /v1/documents. Use instead of content_base64 for PDFs larger than about 3 MB. Provide either upload_id or content_base64, not both.
metadataobjectnoFree-form key-value object stored verbatim on the request.

Backward compatibility: the legacy single-signer body { "signer_email", "signer_name" } is still accepted and treated as a one-element signers array. New integrations should use the signers[] array.

PDF requirements: the file is checked on receipt. Encrypted or password-protected PDFs (pdf_encrypted), unreadable files (pdf_unreadable) and PDFs that already carry a digital signature (pdf_already_signed) are rejected with 400 before anything is charged. Form fields are flattened so that field values become fixed content; if flattening fails the request is rejected (pdf_form_flatten_failed). View-dependent or active content — optional content layers, hidden or print-only annotations, JavaScript and embedded files — is rejected (pdf_unsupported_content) so that the signer sees exactly what the sealed document shows.

Request body

curl -X POST https://api.signeur.eu/v1/signatures \
  -H "Authorization: Bearer sgn_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Order Agreement #1234",
    "message": "Please review and sign.",
    "locale": "en",
    "reply_to": "sales@example.com",
    "signers": [
      { "email": "buyer@example.com",  "name": "Anna Buyer" },
      { "email": "seller@example.com", "name": "Bob Seller", "locale": "fi" }
    ],
    "document": {
      "filename": "contract.pdf",
      "content_base64": "JVBERi0xLjQK..."
    },
    "metadata": { "deal_id": "D-42" }
  }'

Response

{
  "id": "6dc18911-f66b-43d6-9810-8de0b07bab04",
  "status": "sent",
  "expires_at": "2026-06-13T10:51:51.813+00:00",
  "signers": [
    {
      "id": "9c0aa5ec-…",
      "email": "buyer@example.com",
      "name": "Anna Buyer",
      "access_token": "29ErQSUr8Ov…",
      "sign_url": "https://signeur.eu/sign/29ErQSUr8Ov…",
      "email_sent": true,
      "email_error": null,
      "locale": "en"
    },
    {
      "id": "f12d8b3c-…",
      "email": "seller@example.com",
      "name": "Bob Seller",
      "access_token": "kpqDAuVy9-…",
      "sign_url": "https://signeur.eu/sign/kpqDAuVy9-…",
      "email_sent": true,
      "email_error": null,
      "locale": "fi"
    }
  ]
}
GET/v1/signatures/{id}

Get signature request status

Returns the current state of the request, the full signers array and the audit trail. Use for status polling.

Request body

curl https://api.signeur.eu/v1/signatures/<id> \
  -H "Authorization: Bearer sgn_live_..."

Response

{
  "id": "6dc18911-f66b-43d6-9810-8de0b07bab04",
  "status": "signed",
  "title": "Order Agreement #1234",
  "created_at": "2026-05-14T10:51:51.813Z",
  "sent_at":    "2026-05-14T10:51:52.012Z",
  "signed_at":  "2026-05-14T10:52:24.374Z",
  "cancelled_at": null,
  "expires_at": "2026-06-13T10:51:51.813Z",
  "is_expired": false,

  "signers": [
    {
      "id": "9c0aa5ec-…",
      "email": "buyer@example.com",
      "name":  "Anna Buyer",
      "access_token": "29ErQSUr8Ov…",
      "sign_url": "https://signeur.eu/sign/29ErQSUr8Ov…",
      "status": "signed",
      "sent_at":   "2026-05-14T10:51:52.012Z",
      "opened_at": "2026-05-14T10:52:00.481Z",
      "signed_at": "2026-05-14T10:52:24.374Z",
      "declined_at": null,
      "decline_reason": null,
      "locale": "en"
    }
  ],

  "document_hash": "e5132c2fe36dfa219ec600b009d16ef38d20bf0849f7b01ba5ca6e22fec63b56",
  "audit_trail": { "events": [ … ] },
  "metadata": { "deal_id": "D-42" }
}
GET/v1/signatures/{id}/document

Download signed PDF

Returns the locked PDF as binary. Returns 409 if the request is not yet signed.

Request body

curl https://api.signeur.eu/v1/signatures/<id>/document \
  -H "Authorization: Bearer sgn_live_..." \
  -o signed.pdf

Content-Type: application/pdf

GET/v1/signatures

List signature requests

Returns a paginated list of the organization's signature requests with optional filters.

FieldTypeRequiredDescription
statusquerynoFilter by status: pending | sent | opened | signed | cancelled | declined | expired | awaiting_stamp | stamp_failed.
created_fromquerynoOnly return requests created at or after this ISO-8601 timestamp.
created_toquerynoOnly return requests created before this ISO-8601 timestamp.
limitquerynoPage size, 1–100. Default 25.
cursorquerynoOpaque cursor returned by a previous response's next_cursor. Do not construct your own.

Request body

curl "https://api.signeur.eu/v1/signatures?status=sent&limit=10" \
  -H "Authorization: Bearer sgn_live_..."

Response

{
  "data": [
    {
      "id": "6dc18911-f66b-43d6-9810-8de0b07bab04",
      "status": "sent",
      "title": "Order Agreement #1234",
      "signer_count": 2,
      "created_at": "2026-05-14T10:51:51.813Z",
      "sent_at":    "2026-05-14T10:51:52.012Z",
      "signed_at":  null,
      "cancelled_at": null,
      "expires_at": "2026-06-13T10:51:51.813Z",
      "is_expired": false
    }
  ],
  "has_more": true,
  "next_cursor": "eyJjIjoiMjAyNi0wNS0xNFQxMDo1MTo1MS44MTNaIiwiaSI6IjZkYzE4OTExLi4uIn0"
}
POST/v1/signatures/{id}/cancel

Cancel a signature request

Cancels a pending request, invalidates all remaining signer links and fires the signature_request.cancelled webhook.

FieldTypeRequiredDescription
reasonstringnoOptional reason stored in the audit trail (max 500 chars).

Request body

curl -X POST https://api.signeur.eu/v1/signatures/<id>/cancel \
  -H "Authorization: Bearer sgn_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "reason": "Sent to wrong recipient" }'

Response

{
  "id": "6dc18911-f66b-43d6-9810-8de0b07bab04",
  "status": "cancelled",
  "cancelled_at": "2026-05-17T08:14:02.913Z"
}

Effect: status becomes 'cancelled', all unsigned signer links are invalidated and the signature_request.cancelled webhook is fired. The original PDF is preserved but no longer downloadable through /document.

GET/v1/signatures/{id}/signers

List signers for a request

Returns all signers for one signature request with per-signer status, timestamps and audit trail. Use to render multi-signer progress dashboards.

Request body

curl "https://api.signeur.eu/v1/signatures/<id>/signers" \
  -H "Authorization: Bearer sgn_live_..."

Response

{
  "data": [
    {
      "id": "9c0aa5ec-…",
      "email": "buyer@example.com",
      "name":  "Anna Buyer",
      "name_as_invited": "Anna Buyer",
      "name_as_signed":  "Anna H. Buyer",
      "access_token": "29ErQSUr8Ov…",
      "sign_url": "https://signeur.eu/sign/29ErQSUr8Ov…",
      "status": "signed",
      "position": 0,
      "sent_at":   "2026-05-14T10:51:52.012Z",
      "opened_at": "2026-05-14T10:52:00.481Z",
      "signed_at": "2026-05-14T10:52:24.374Z",
      "declined_at": null,
      "decline_reason": null,
      "invalidated_at": null,
      "ip_address": "87.92.91.57",
      "user_agent": "Mozilla/5.0 (Macintosh; …) Safari/605.1.15",
      "ip_country": "FI",
      "ip_city": "Helsinki",
      "locale": "en",
      "representing_as_invited": null,
      "representing_as_signed":  null,
      "representing_role":       null,
      "representing_entity_id":  null,
      "audit_trail": { "events": [ … ] }
    },
    {
      "id": "f12d8b3c-…",
      "email": "seller@example.com",
      "status": "pending",
      "position": 1,
      "...": "..."
    }
  ]
}
POST/v1/signatures/{id}/signers/{signer_id}/resend

Resend invitation to a signer

Sends the invitation email to one signer again with a freshly rotated access code. The old code stops working immediately.

FieldTypeRequiredDescription
localestringnoOptional. Override the signer's email locale for this send and persist the change on the signer row. Allowed: 'en' | 'fi' | 'fr' | 'de'.

Request body

curl -X POST https://api.signeur.eu/v1/signatures/<id>/signers/<signer_id>/resend \
  -H "Authorization: Bearer sgn_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "locale": "fi" }'

Response

{
  "ok": true,
  "signer_id": "9c0aa5ec-…",
  "email_sent": true,
  "email_error": null,
  "access_code_rotated_at": "2026-05-17T10:14:33.872Z"
}

Effect: a new 6-digit access code is generated, stored as a bcrypt hash and emailed to the signer. The previously emailed code no longer authenticates the access-code gate. Attempt counters and any temporary lockouts are reset.

GET/v1/signatures/{id}/audit-trail.pdf

Download audit-trail PDF

Returns a standalone PDF containing the full audit record: request metadata, signer details with IPs and user agents, chronological event timeline, and PAdES signature info when the request is sealed. This PDF is informational and is NOT cryptographically signed — the sealed document itself is the legal evidence.

Request body

curl https://api.signeur.eu/v1/signatures/<id>/audit-trail.pdf \
  -H "Authorization: Bearer sgn_live_..." \
  -o audit-trail.pdf

Content-Type: application/pdf · The PDF is generated on demand from the current state of the request and audit trail. Available regardless of request status.

GET/v1/webhook-endpoints

List webhook endpoints

Returns all webhook endpoints configured for your organization. Secrets are not included in the listing — they are shown only once when the endpoint is created.

Request body

curl https://api.signeur.eu/v1/webhook-endpoints \
  -H "Authorization: Bearer sgn_live_..."

Response

{
  "data": [
    {
      "id": "ep_a1b2c3d4-…",
      "url": "https://example.com/hooks/signeur",
      "event_types": ["signature_request.completed", "signer.signed"],
      "description": "Production sync",
      "disabled_at": null,
      "created_at": "2026-05-17T10:00:00.000Z",
      "updated_at": "2026-05-17T10:00:00.000Z"
    }
  ]
}
POST/v1/webhook-endpoints

Create a webhook endpoint

Registers a new URL to receive webhook events. The response includes a freshly generated `secret` which is shown only this once and is used to verify HMAC signatures on incoming webhooks.

FieldTypeRequiredDescription
urlstringyesTarget URL (must use https:// in production, http://localhost is allowed for development).
event_typesstring[]noArray of event types to receive. Empty array (or omitted) means receive all events.
descriptionstringnoOptional short human-readable label for the endpoint (max 200 chars).

Request body

curl -X POST https://api.signeur.eu/v1/webhook-endpoints \
  -H "Authorization: Bearer sgn_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/hooks/signeur",
    "event_types": ["signature_request.completed", "signer.signed"],
    "description": "Production sync"
  }'

Response

{
  "id": "ep_a1b2c3d4-…",
  "url": "https://example.com/hooks/signeur",
  "secret": "whsec_7f3a9c…",
  "event_types": ["signature_request.completed", "signer.signed"],
  "description": "Production sync",
  "disabled_at": null,
  "created_at": "2026-05-17T10:00:00.000Z",
  "updated_at": "2026-05-17T10:00:00.000Z"
}

Important: the secret is shown ONLY in this response. Signeur does not retain a plaintext copy. If you lose it, delete this endpoint and create a new one.

PATCH/v1/webhook-endpoints/{id}

Update a webhook endpoint

Updates the URL, event_types, description or disabled state of an endpoint. All body fields are optional — only the provided ones are changed.

FieldTypeRequiredDescription
urlstringnoTarget URL (must use https:// in production, http://localhost is allowed for development).
event_typesstring[]noArray of event types to receive. Empty array (or omitted) means receive all events.
descriptionstringnoOptional short human-readable label for the endpoint (max 200 chars).
disabledbooleannotrue = pause delivery without deleting the endpoint, false = resume.
DELETE/v1/webhook-endpoints/{id}

Delete a webhook endpoint

Permanently removes the endpoint. Events stop being delivered to it immediately. The secret is unrecoverable after deletion.

curl -X DELETE https://api.signeur.eu/v1/webhook-endpoints/<id> \
  -H "Authorization: Bearer sgn_live_..."

Webhooks

Signeur pushes real-time events to one or more URLs you configure for your organization whenever a signature request's state changes. Each event is signed with HMAC-SHA256 and delivered in parallel to all matching endpoints. This is more efficient than polling the GET endpoint.

Supported events

signature_request.createdA new signature request was created. Fires once per request, includes the full signers list.
signature_request.sentThe invitation email batch was attempted for all signers. Includes per-signer email_sent status.
signature_request.openedA signer opened the link for the first time. Fires once per request when the first signer opens it.
signer.signedOne signer successfully verified their OTP and signed. Fires N times for an N-signer request.
signature_request.completedAll signers have signed and the document is sealed. Includes document_hash and download_url.
signature_request.signedDeprecated alias for signature_request.completed — fires at the same time. Use signature_request.completed for new integrations.
signature_request.declinedA signer declined; the request was moved to status 'declined' and remaining signers were invalidated.
signature_request.cancelledThe request was cancelled via the dashboard or POST /signatures/{id}/cancel.
signature_request.expiredThe request reached expires_at without all signers completing. Fires once per request when the daily expire-cron flips status to 'expired'.

Payload format

// signer.signed — fires once per signer that finishes signing
{
  "id": "evt_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "signer.signed",
  "created_at": "2026-05-14T10:52:24.374Z",
  "data": {
    "signature_request_id": "6dc18911-f66b-43d6-9810-8de0b07bab04",
    "signer_id": "9c0aa5ec-…",
    "signer_email": "buyer@example.com",
    "signer_name":  "Anna Buyer",
    "signed_at": "2026-05-14T10:52:24.374Z",
    "remaining_pending_signers": 1
  }
}

// signature_request.completed — fires once when all signers are done
// and the PDF is sealed. signature_request.signed is a deprecated alias
// that fires at the same moment with the same payload.
{
  "id": "evt_b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "type": "signature_request.completed",
  "created_at": "2026-05-14T10:55:11.812Z",
  "data": {
    "signature_request_id": "6dc18911-f66b-43d6-9810-8de0b07bab04",
    "status": "signed",
    "signed_at": "2026-05-14T10:55:11.812Z",
    "document_hash": "e5132c2fe36dfa…",
    "download_url": "https://api.signeur.eu/v1/signatures/6dc18911-…/document"
  }
}

Signature verification

Each webhook is signed with HMAC-SHA256 in the X-Signeur-Signature header. Verify it to ensure the request genuinely came from Signeur. Reject deliveries whose timestamp is more than 5 minutes old and compare digests in constant time (e.g. timingSafeEqual) to defend against replay and timing attacks.

Header format:

X-Signeur-Signature: t=1747212744,v1=abc123def456...

Signed data:

<timestamp>.<raw json body>

Verification example (Node.js):

import { createHmac, timingSafeEqual } from "crypto";

// 1. Parse the header: t=<unix seconds>,v1=<hex digest>
const sig = req.headers["x-signeur-signature"];
const [t, v1] = sig.split(",").map(s => s.split("=")[1]);

// 2. Reject stale deliveries (replay protection, 5 min tolerance)
const ageSeconds = Math.abs(Date.now() / 1000 - Number(t));
if (!Number.isFinite(ageSeconds) || ageSeconds > 300) throw new Error("Stale webhook");

// 3. Recompute the digest over `${t}.${rawBody}` (raw bytes, not re-serialised JSON)
const expected = createHmac("sha256", YOUR_WEBHOOK_SECRET)
  .update(`${t}.${rawBody}`).digest("hex");

// 4. Constant-time comparison (never `v1 !== expected`)
const a = Buffer.from(v1 ?? "", "hex");
const b = Buffer.from(expected, "hex");
if (a.length !== b.length || !timingSafeEqual(a, b)) throw new Error("Invalid signature");

Configuration

Configure endpoints in two ways: (a) Dashboard → Webhooks gives a UI to add, edit, pause or delete endpoints and pick which event types each one receives. (b) The REST API at /v1/webhook-endpoints lets you manage them programmatically. Each endpoint gets its own HMAC secret which is shown once at creation — store it securely. A legacy single-URL webhook on the organization is still honored as a fallback when no endpoints exist on the new table.

Delivery

When an event fires, Signeur looks up all enabled endpoints that subscribe to the event type and delivers the payload to each in parallel (5 second timeout per endpoint). Each attempt is logged separately to the signature request's audit trail with the endpoint id, HTTP status and any error. A retry queue is on the roadmap.

MCP server

Signeur exposes the same API to AI agents as an MCP server (Model Context Protocol, Streamable HTTP, stateless). Every tool call runs through the REST API above, so authentication, rate limits, idempotency, billing and audit logging behave exactly as with direct HTTP calls. Suitable for Claude Desktop, Claude Code, Cursor and any other MCP client that can send an Authorization header.

Connecting

Endpoint: https://api.signeur.eu/mcp. Authenticate with an API key from the dashboard in the Authorization header; there is no OAuth flow. Example client configuration:

{
  "mcpServers": {
    "signeur": {
      "url": "https://api.signeur.eu/mcp",
      "headers": { "Authorization": "Bearer sgn_live_YOUR_KEY" }
    }
  }
}

The key's owner (personal or organization context) decides which requests are visible and whose subscription is billed. Revoking the key in the dashboard also disconnects MCP clients immediately. Clients that only support OAuth login (for example hosted connectors) cannot connect yet.

Tools

Tracking (free)

list_signature_requestsList your signature requests with status and date filters and cursor pagination.
get_signature_requestStatus, signers, timestamps, document hash and PDF retention of one request.
list_signersEvery signer of a request with their individual status.
get_document_linksAPI links to the sealed PDF and the audit-trail PDF of a signed request (fetched with the same key).

Sending

create_upload_urlPre-signed upload URL for PDFs larger than about 3 MB; smaller files can be passed inline as base64.
prepare_signature_requestValidate signers and the PDF and return the total price without creating anything.
create_signature_requestCreate the request and send the invitations. Billable; requires confirm=true after the user approved the preview.
cancel_signature_requestCancel a pending request.
resend_invitationResend the invitation email to one signer.

Webhooks

list_webhook_endpointsConfigured endpoints without secrets.
create_webhook_endpointRegister a webhook URL; the HMAC secret is returned once.
rotate_webhook_secretReplace an endpoint's HMAC secret.

Billing and limits

Only create_signature_request costs money: 0.89 € incl. VAT per signer, charged to the key owner's active API subscription (402 without one). The tool is two-step by design: prepare_signature_request returns a summary and the price with no side effects, and create_signature_request only proceeds with confirm=true. Each creation carries an automatic Idempotency-Key, so a retried identical call never creates a duplicate. The API limits of 10 requests per minute and 100 per day per key apply to tool calls as well.

Resources and prompts

The server also serves llms.txt, the OpenAPI description and auth.md as resources, plus two prompts: a guided send-for-signature flow and webhook signature verification.

The machine-readable server card is at /.well-known/mcp/server-card.json.

Coming soon

The following features are planned:

  • → Automatic expiry detection that fires signature_request.expired (currently the status remains 'sent'/'opened' even after expires_at)
  • → Webhook retry queue — currently each delivery is a single attempt; failed events do not retry
  • → Idempotency-Key support on cancel and resend endpoints (currently only POST /signatures)
  • → Webhook delivery history view in the dashboard