/v1/formsBuild a form
Creates a form, and always as a DRAFT — post_forms_id_publish is what opens the public door afterwards. Body: name, an optional slug (lowercase letters, numbers and hyphens; the words drafts and submissions are refused because the public router already means something by them), fields, sections, settings, and targetDefinitionKey naming the record page answers should land on. A form that fills a board is post_forms_from-board: it writes the questions from the board's columns and publishes in one call.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"createdAt": "2026-01-01T00:00:00Z",
"createdBy": "string",
"description": "string",
"fields": [
{
"accept": "string",
"alsoFills": "string",
"alternativeTo": "string",
"column": "string",
"content": "string",
"defaultValue": "string",
"documentType": "string",
"entityType": "string",
"id": "",
"kind": "string",
"label": "string",
"maxFileSizeMb": "string",
"maxFiles": "string",
"offerBank": "string",
"options": "string",
"placeholder": "string",
"required": "string",
"signerNameFieldId": "",
"slider": "string",
"validation": "string",
"visibility": "string"
}
],
"id": "",
"name": "string",
"publishedAt": "2026-01-01T00:00:00Z",
"sections": [
{
"fieldIds": "string",
"title": "string",
"visibility": "string"
}
],
"settings": {
"analytics": true,
"applicationPdfs": "string",
"automations": [
"string"
],
"branding": "string",
"dealLanding": "string",
"legal": "string",
"notifications": "string",
"pacing": "string",
"postSubmit": "string",
"saveDrafts": true,
"signature": "string",
"theme": "string"
},
"slug": "string",
"sourceUrl": "string",
"stats": {
"submissions": 1,
"views": 1
},
"status": "string",
"targetDefinitionKey": "string",
"updatedAt": "2026-01-01T00:00:00Z"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}