Getting Started
Welcome to the Formalingo API. Build forms, digital signatures, and document workflows programmatically.
Getting Started
The Formalingo REST API lets you create and manage forms, digital signature documents, recipients, and submissions — all programmatically from your own application.
Base URL
All API requests are made to:
https://formalingo.com/api/v1Quick Start
1. Generate an API key from Settings → API Keys in your dashboard.
2. Make your first request:
curl https://formalingo.com/api/v1/forms \
-H "Authorization: Bearer af_live_YOUR_KEY"3. Create a form:
curl -X POST https://formalingo.com/api/v1/forms \
-H "Authorization: Bearer af_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "title": "My First Form" }'What you can do
| Resource | Description |
|---|---|
| Forms | Create forms with sections, questions, branding, and logic |
| Recipients | Add recipients with optional pre-filled answers |
| Documents | Upload PDFs/DOCX and place signature fields |
| Submissions | Create signing submissions with pre-filled data |
| Webhooks | Receive real-time events when forms are submitted or documents are signed |
Response format
All endpoints return a consistent JSON envelope:
{
"success": true,
"data": { ... },
"meta": { "total": 42, "page": 1, "limit": 20 }
}Errors follow the same envelope with success: false:
{
"success": false,
"error": "Form not found",
"hint": "Check that the ID is correct and belongs to your workspace."
}See Error Reference for all error codes.