API Reference
Find the OpenAPI specification and the main API areas available for integrations.
The FormWork API is available for teams that need custom integrations, reporting, migrations, or developer-built workflows around FormWork data.
Most users do not need to use the API directly. Start with the builder, workflows, extensions, imports, and exports before choosing a custom API integration.
Interactive API Docs
Use the interactive OpenAPI documentation for full endpoint details, request fields, and response examples.
Interactive API Docs
Browse endpoints, schemas, and examples in the generated OpenAPI reference.
View API DocumentationOpenAPI Specification
| Format | URL |
|---|---|
| JSON | openapi.json |
| YAML | openapi.yaml |
Authentication
API keys are managed from account settings.
Send the key in the Authorization header:
curl -H "Authorization: Bearer fwk_your_api_key" \
https://app.useformwork.com/api/v1/formsSee API Keys for creating and managing keys.
Main API Areas
| Area | What it is for |
|---|---|
| Accounts and users | Manage account details, users, roles, and account switching. |
| Billing | Read billing status and create checkout or billing portal sessions. |
| Projects | Create and manage projects. |
| Forms and form versions | Create forms, edit drafts, validate versions, publish, and manage fields. |
| Entry sessions | Public form rendering, answer updates, repeatable groups, submission, buttons, draft resume, and upload flow. |
| Entries and revisions | Admin entry management, answers, metafields, files, edit sessions, revisions, and workflow runs. |
| Data tables | Create tables and manage rows for structured operational data. |
| Workflows | Manage workflow definitions, triggers, steps, connections, runs, and run details. |
| References | Search and resolve references used by workflows, templates, and mappings. |
| Views, imports, and exports | Saved entry views, CSV imports, exports, and background job tracking. |
| Files and jobs | Prepare uploads, complete uploads, download files, and track background jobs. |
| Extensions | Manage installed extensions, custom API integrations, extension configs, secrets, actions, and webhooks. |
| Templates | Manage reusable content and layout templates. |
Public Form Endpoints
Embedded forms use public entry-session endpoints behind the scenes. These endpoints support:
- Loading a public form schema before an entry exists
- Creating a draft entry
- Updating answers
- Adding and removing repeatable group instances
- Submitting an entry
- Handling button clicks
- Supporting draft resume flows
- Uploading files
- Calling entry-scoped extension actions
For normal embeds, use the Web Component instead of calling these endpoints directly.
When to Use the API
Use the API when you need to:
- Move data between FormWork and another system
- Build custom reporting
- Create or update entries from another application
- Automate project or form setup
- Connect a process that is too specific for a no-code workflow alone
Use custom API extensions when the external service should be called from a workflow step. Use the REST API when the external system needs to manage FormWork data directly.