eSignature REST API — Direct Integration

A clean REST API with JSON requests, API key authentication, and webhooks. Works with any language, any framework, any platform that can make an HTTPS call.

What you can do with the REST API

  • Generate a PDF from a template and send it for signing in a single API call
  • Define recipients, roles, field positions, signing order, and expiry in the request body
  • Receive real-time webhook events when documents are sent, viewed, signed, or completed
  • Download the signed PDF with the embedded audit trail via the completion webhook URL
  • Manage templates, documents, and signing requests programmatically
  • Use regional endpoints (US, EU, Singapore, Australia) for data residency compliance

Authentication

eSignature API uses API key authentication. Include your API key in the request header:

header
X-API-KEY: your_api_key

Get your API key from your CraftMyPDF dashboard after signing up. The free plan includes 50 documents per month — no credit card required.

Basic signing request

cURL
curl -X POST https://api.craftmypdf.com/v1/create \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "your_template_id",
    "signers": [
      {
        "name": "Jane Smith",
        "email": "jane@example.com",
        "role": "signer",
        "order": 1
      },
      {
        "name": "John Manager",
        "email": "john@example.com",
        "role": "signer",
        "order": 2
      }
    ],
    "callback_url": "https://yourapp.com/webhooks/esign"
  }'

Webhook events

When a document is completed, eSignature API sends a POST request to your callback_url with:

  • Document ID and status
  • Signer details and timestamps
  • Signed PDF download URL
  • Audit trail data

Use this to trigger downstream actions in your application: update a database record, send a confirmation email, or archive the signed document.

Regional endpoints

eSignature API provides endpoints in four regions for data residency compliance:

RegionEndpoint
United Statesapi.craftmypdf.com (US)
European Unionapi-eu.craftmypdf.com
Singaporeapi-sg.craftmypdf.com
Australiaapi-au.craftmypdf.com

Common questions

What languages and frameworks does eSignature API support?
eSignature API is a standard REST API with JSON — it works with any language or framework that can make HTTPS requests: Python, Node.js, PHP, Ruby, Java, C#, Go, or any other. No language-specific SDK is required.
How do I test the API before going live?
Use your free plan account to test in production — the free plan includes 50 real, legally binding documents per month. Alternatively, use a tool like Postman to test API calls against the endpoint with your API key.
Where is the full API documentation?
Full API reference, endpoint details, parameter definitions, and code examples are at support.craftmypdf.com.

Back to all integrations

Start integrating eSignature API today

Free plan. 50 documents per month. No credit card. Full docs included.