UnlayeredUnlayered
API Reference

Build with Unlayered API

RESTful API for forms, eSignatures, and workflow automation. Complete with SDKs, webhooks, and detailed examples.

Example: Create a form via API
curl https://api.unlayered.com/v1/forms \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Contact Form",
    "fields": [
      {"type": "text", "label": "Name", "required": true},
      {"type": "email", "label": "Email", "required": true}
    ]
  }'

API quickstart

Get your API key and make your first request in 5 minutes

1

Get your API key

Sign up and generate your API key from the dashboard. Keep it secure. It's like a password.

Generate API Key
2

Authenticate your requests

Include your API key in the Authorization header as a Bearer token.

Authorization: Bearer YOUR_API_KEY
3

Make your first request

Try listing your forms. Base URL: https://api.unlayered.com/v1

curl https://api.unlayered.com/v1/forms \
  -H "Authorization: Bearer YOUR_API_KEY"

API resources

Complete documentation for all API endpoints

Forms

Create, read, update, and delete forms. Configure fields, validation, conditional logic, and styling.

Endpoints:
POST/forms
GET/forms/:id
PUT/forms/:id
DELETE/forms/:id
GET/forms/:id/submissions

Submissions

Retrieve form submissions, export data, and manage submission lifecycle.

Endpoints:
GET/submissions
GET/submissions/:id
PUT/submissions/:id
DELETE/submissions/:id

Documents & Signatures

Send documents for signature, add signers, track status, and download signed documents.

Endpoints:
POST/documents
GET/documents/:id
POST/documents/:id/send
GET/documents/:id/download

Workflows

Create and manage automated workflows with forms, signatures, and integrations.

Endpoints:
POST/workflows
GET/workflows/:id
PUT/workflows/:id
POST/workflows/:id/trigger

Webhooks

Subscribe to real-time events. Get notified when forms are submitted, documents are signed, and more.

Endpoints:
POST/webhooks
GET/webhooks
PUT/webhooks/:id
DELETE/webhooks/:id

Templates

Manage form and document templates. Create reusable templates for common workflows.

Endpoints:
POST/templates
GET/templates
GET/templates/:id
POST/templates/:id/use

SDKs & code libraries

Official SDKs for popular programming languages

JavaScript/TypeScript

npm install unlayered-js
View Docs

Python

pip install unlayered
View Docs

Ruby

gem install unlayered
View Docs

PHP

composer require unlayered/sdk
View Docs

API features

Secure Authentication

Bearer token authentication with API keys. Support for OAuth 2.0 coming soon.

Real-time Webhooks

Subscribe to events and get instant notifications when forms are submitted or documents are signed.

RESTful Design

Clean, predictable REST API with JSON payloads and standard HTTP methods.

Pagination & Filtering

Efficient data retrieval with cursor-based pagination and advanced filtering.

Rate Limiting

1000 requests per minute. Rate limit headers included in all responses.

OpenAPI Spec

Complete OpenAPI 3.0 specification. Generate client SDKs automatically.

Start building with Unlayered API

Get your API key and make your first request in minutes