Referencia de APIForms / Form
Create Form
← Back to full API reference
POST
/v1/formsAuth required- Requires organization permissions for this resource.
- Validated by Zod schema: postForm.
Request details
Body fields
| Field | Required | Description |
|---|---|---|
| name | Yes | Type: string |
| description | Yes | Type: string |
| cta | No | Type: string |
| formSchema | Yes | Type: arrayExample: |
| formSchema[] | Yes | Type: object |
| formSchema[].label | Yes | Type: string |
| formSchema[].type | Yes | Type: enumExample: text |
| formSchema[].span | No | Type: number |
| formSchema[].options | No | Type: arrayExample: |
| formSchema[].options[] | Yes | Type: string |
| formSchema[].unique | No | Type: boolean |
| formSchema[].content | No | Type: string |
| uiSchema | No | Type: unknown |
| columns | No | Type: numberExample: 1 |
| submissionLimit | No | Type: number |
| isEvent | No | Type: booleanExample: false |
| eventDate | No | Type: string |
| eventDuration | No | Type: number |
Default payloads
Path params
json
{}Query
json
{}Body
json
{
"name": "string",
"description": "string",
"formSchema": [
{
"label": "string",
"type": "text"
}
]
}Sample response
json
{
"id": "<newFormId>"
}