---
title: "Create a form schema"
method: POST
path: "/app/v1/form_schemas"
tags: ["form_schemas"]
---

# Create a form schema

`POST /app/v1/form_schemas`

## Request body

- FormSchemaInput
  - `config` FormSchemaConfig
    - `questions` object
    - `sections` object[]
      - `description` string, required
      - `id` string, required
      - `name` string, required — Should not start with a number
      - `is_repeatable` boolean
      - `questions` string[], required
  - `description` string
  - `form_submission_editable` boolean
  - `form_category_id` string, uuid
  - `name` string
  - `status` 'active' | 'archived' | 'draft'
  - `form_submission_default_status` 'validated' | 'invalidated' | 'pending' | 'submitted' | 'draft'

## Response `200`

A successful operation

- FormSchema
  - `company_id` string, uuid
  - `config` FormSchemaConfig
    - `questions` object
    - `sections` object[]
      - `description` string, required
      - `id` string, required
      - `name` string, required — Should not start with a number
      - `is_repeatable` boolean
      - `questions` string[], required
  - `created_at` string, date-time
  - `created_by` string, uuid
  - `description` string
  - `form_submission_editable` boolean
  - `form_category_id` string, uuid
  - `id` string, uuid
  - `name` string
  - `status` 'active' | 'archived' | 'draft'
  - `updated_at` string, date-time
  - `version` integer

---

[API](https://skmtc.net/validere/apis/carbonhub-api.md) · [All operations](https://skmtc.net/validere/apis/carbonhub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/validere/carbonhub-api/revisions/053edab62415/schema)