Create a question

post

https://app.voiceform.com/api/v1/surveys/{survey_id}/questions

Feature gates:

matrix requires plan feature matrix_question
file-upload requires plan feature file_upload
other non-basic types require all_question_types

properties and multiple_choice_items are validated per type (unknown property keys are stripped).
Create applies product defaults when omitted (e.g. voice record times, 5-star rating, 3×4 matrix).
Choice types (multiple-choice, dropdown, checkbox) require at least one multiple_choice_items[].value.
See schema components QuestionProperties*, MatrixColumn, and MultipleChoiceItem.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

survey_id

uuid

required

Body Params

type

string

enum

required

matrix requires feature matrix_question.
file-upload requires feature file_upload.

text

string | null

properties

object | null

Union of allowed keys across question types. Only keys valid for the question's type
are kept; others are stripped. Prefer the type-specific shapes below.

multiple_choice_items

array | null

Required (≥1) for multiple-choice, dropdown, and checkbox.
Rating uses RatingItem objects (defaults to 5 stars).
Must be empty/omitted for voice, matrix, file-upload, yesno, etc.

multiple_choice_items

is_optional

boolean

order

integer

description

string | null

Responses

201Created question

defaultAPI error