POST/v1/forms

Create forms

Not yet documented — no summary in the API source.

RequiresAuthorization: Bearer sk_...tenant_id

Request body application/json

idstringnullable
tenant_idstringnullable
created_atstring (date-time)
updated_atstring (date-time)
typestringrequiredmin length 1
titlestringrequiredmin length 1
subHeaderstringnullable
descriptionstringnullable
submit_actionstringrequiredmin length 1
fieldsarray of objectClientFormFieldrequired
typestringrequiredmin length 1
namestringrequiredmin length 1
identifierstringrequiredmin length 1
descriptionstringrequiredmin length 1
validationstringnullable
orderinteger (int32)required
temp_valuestringnullable
temp_regulationstringnullable
temp_value_typestringnullable
optionsarray of objectClientFormFieldOptionnullable
valuestringnullable
labelstringrequiredmin length 1
sub_optionsarray of ClientFormFieldSubOptionClientFormFieldSubOptionnullable
boolean_valueboolean

Responses

object ClientForm — same shape as the request body.

curl --request POST \
  --url 'https://api.4comply.io/v1/forms' \
  --header 'Authorization: Bearer sk_...' \
  --header 'tenant_id: your-tenant-id' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "00000000-0000-0000-0000-000000000000",
  "tenant_id": "your-tenant-id",
  "created_at": "2026-09-07T12:00:00Z",
  "updated_at": "2026-09-07T12:00:00Z",
  "type": "string",
  "title": "Example label",
  "subHeader": "string",
  "description": "Example text",
  "submit_action": "string",
  "fields": [
    {
      "type": "string",
      "name": "Example name",
      "identifier": "string",
      "description": "Example text",
      "validation": "string",
      "order": 1,
      "temp_value": "string",
      "temp_regulation": "string",
      "temp_value_type": "string",
      "options": [
        {
          "value": "string",
          "label": "Example label",
          "sub_options": [],
          "boolean_value": true
        }
      ]
    }
  ]
}'