Create a survey

Creates a post-call survey on your account, allocates it an extension and publishes the call routing that reaches it. Questions are added separately, through /api/v1/surveys/{id}/questions. survey_enabled defaults to false, but the routing is published enabled regardless, so the extension answers as soon as the survey exists. default_voice and question_order are accepted by the schema and ignored here — set them with a follow-up update.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Name of the survey, also used to name its call routing. Required and nonblank.

string
required

What the survey is for. Required and nonblank.

boolean

Whether the survey is active. Defaults to false.

string

Language every question falls back to, as en or en-US. Defaults to en.

invalid_actions
array of objects

What to do when a caller presses something the question does not accept; each action needs an app. Defaults to none.

invalid_actions
timeout_actions
array of objects

What to do when a caller says nothing in time; each action needs an app. Defaults to none.

timeout_actions
string

Accepted by the schema but ignored when creating; set it with a later update.

question_order
array of strings

Accepted by the schema but ignored when creating; order questions with a later update.

question_order
Responses

401

Missing or invalid API key.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json