---
title: "Post a user survey form"
method: POST
path: "/user-surveys/form"
tags: ["user-surveys"]
---

# Post a user survey form

`POST /user-surveys/form`

## Request body

- CreateUserSurveyFormRequest
  - `survey_form` UserSurveyForm, required
    - `items` UserSurveyFormItem[], required
      - `id` string, required
      - `label` string, required
      - `label_short` string, nullable
      - `label_short_translations` object, nullable
      - `label_translations` object, nullable
      - `optional` boolean, nullable
      - `widget` union, required
        - UserSurveyFormWidgetHeading
          - `type` 'heading', required
        - UserSurveyFormWidgetInputRadio
          - `options` UserSurveyFormWidgetInputOption[], required
            - `label` string, required
            - `label_translations` object, nullable
            - `value` union, required
              - …
          - `selection-type` string, nullable
          - `type` 'input-radio', required
        - UserSurveyFormWidgetInputMulticheck
          - `options` UserSurveyFormWidgetInputOption[], required
            - `label` string, required
            - `label_translations` object, nullable
            - `value` union, required
              - …
          - `selection-type` string, nullable
          - `type` 'input-multicheck', required
        - UserSurveyFormWidgetInputScale
          - `default_value` union
            - string
            - integer
          - `label_max` string
          - `label_max_short` string, nullable
          - `label_max_short_translations` object, nullable
          - `label_max_translations` object, nullable
          - `label_min` string
          - `label_min_short` string, nullable
          - `label_min_short_translations` object, nullable
          - `label_min_translations` object, nullable
          - `options` UserSurveyFormWidgetInputOption[], nullable
            - `label` string, required
            - `label_translations` object, nullable
            - `value` union, required
              - …
          - `range` integer[], required
          - `range_interval` integer, nullable
          - `type` 'input-scale', required
        - UserSurveyFormWidgetInputText
          - `multiline` boolean, nullable
          - `placeholder` string
          - `placeholder_translations` object, nullable
          - `type` 'input-text', required
  - `survey_type` 'mindful-eating' | 'recipe-suggestion_like' | 'recipe-suggestion_dislike' | 'meal-substitution-suggestion_like' | 'meal-substitution-suggestion_dislike', required

## Response `200`

successful operation

---

[API](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server.md) · [All operations](https://skmtc.dev/rxfoodapp/apis/inneranalytics-mnt-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rxfoodapp/inneranalytics-mnt-server/revisions/0703cbbbefe8/schema)