NomaSign E-Signature API for Developers

Build custom integrations with the NomaSign API: send documents for signature, receive webhooks, and automate your workflows.

Get Started

Choose how you want to explore the API:

Two Ways to Send

Same layout every time? Use a template. Documents generated per transaction? Send them directly.

Recommended

Send a Template

Design a document pack once in the web app, then each send is a small, fast call with recipients and field values. Lightest on your API allowance.

POST /api/templates/send
For generated documents

Send Your Own PDFs

Upload your generated PDFs to your connected cloud drive and send them by file id. Initials are placed on every page and a signature page is added at the end, and you get a signing link per signer to deliver yourself.

POST /api/sessions/send

How It Works

1

Authenticate

Exchange your Refresh Token for a short-lived Access Token via POST /connect/token.

2

Send a Document

Call POST /api/templates/send with the template ID, recipient details, and field values. NomaSign creates the signing request and emails the document to the signer.

{
  "templateId": "<template-id>",
  "signingRequests": [
    {
      "recipients": [
        { "label": "Recipient 1", "name": "Jane Smith", "email": "jane.smith@nomasign.com" }
      ],
      "fields": [{ "label": "customer_name", "value": "Jane Smith" }]
    }
  ]
}

A placeholder with no matching recipient returns 400 unmapped_placeholders. Sending your own generated PDFs instead? Use POST /api/sessions/send with your cloud file ids and get a signing link per signer.

3

Receive Webhooks

NomaSign sends HMAC-signed webhook events to your endpoint when documents are signed.

New to NomaSign? Start with the setup guide →

What You Can Build

Send Documents via API

Trigger signature requests from your CRM, HR system, or any backend — pre-fill recipient details and custom fields.

Send Generated Documents

Your system builds the PDFs? Send them directly for signature and deliver the returned signing links through your own channels.

Receive Webhook Notifications

Get real-time notifications when documents are signed. Verify with HMAC-SHA256.

Template Automation

Create templates once in the web app, then instantiate them via API with different recipients and field values each time.

Custom Workflows

Combine sending and webhooks to build fully automated document workflows — onboarding, contracts, compliance, and more.

Ready to integrate?

Sign up, create your integration account, and start building in minutes.