---
title: "Create a section"
method: POST
path: "/v1/surveys/{id}/sections"
tags: ["survey"]
---

# Create a section

`POST /v1/surveys/{id}/sections`

## Path parameters

- `id` number, required

## Request body

- Model185
  - `name` string
  - `description` string
  - `properties` Model175
    - `label` string
    - `sectionRandomise` boolean
  - `displayLogic` DisplayLogic
    - `logics` Model176[]
      - `join_condition` 'and' | 'or'
      - `type` 'param', required
      - `comparator` 'isPassed' | 'isNotPassed' | 'startsWith' | 'endsWith' | 'contains' | 'equalsString' | 'doesNotContain' | 'notEqualTo' | 'lessThanForParam' | 'greaterThanForParam', required
      - `variable_id` number
      - `value` string
  - `questions` Model183[]
    - `text` string, required
    - `description` string
    - `required` boolean
    - `type` 'FileInput' | 'TextInput' | 'OpinionScale' | 'MultiChoice', required
    - `desc` string
    - `optionsStacked` boolean
    - `randomized` boolean
    - `multipleAnswers` boolean
    - `img` string
    - `video` string
    - `audio` string
    - `tags` string[]
    - `choices` Model179[]
      - `text` string
      - `score` number
    - `hasScore` boolean
    - `other` boolean
    - `allOfTheAbove` boolean
    - `noneOfTheAbove` boolean
    - `otherText` Model179
      - `text` string
      - `score` number
    - `noneOfTheAboveText` Model179
      - `text` string
      - `score` number
    - `allOfTheAboveText` AllOfTheAboveText
      - `text` string
    - `properties` Model182
      - `data` Model181
        - `min` string
        - `max` string
        - `step` 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
        - `wait` 0 | 1 | 2 | 3 | 4 | 5
        - `type` 'SINGLE_LINE' | 'MULTI_LINE' | 'UNLIMITED' | 'EXACT' | 'RANGE'
        - `start` 0 | 1
        - `fileTypes` string[]
        - `minLimit` number
        - `maxLimit` number
        - `exactChoices` number
    - `displayLogic` DisplayLogic
      - `logics` Model176[]
        - `join_condition` 'and' | 'or'
        - `type` 'param', required
        - `comparator` 'isPassed' | 'isNotPassed' | 'startsWith' | 'endsWith' | 'contains' | 'equalsString' | 'doesNotContain' | 'notEqualTo' | 'lessThanForParam' | 'greaterThanForParam', required
        - `variable_id` number
        - `value` string

## Response `default`

Successful

---

[API](https://skmtc.net/surveysparrow/apis/api-documentation.md) · [All operations](https://skmtc.net/surveysparrow/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surveysparrow/api-documentation/versions/f9da74f558da/schema)
