Skip to main content
POST
Create survey

Authorizations

Authorization
string
header
required

OAuth2 access token obtained via the authorization flow. Include in the Authorization header as: Bearer {access_token}

Body

application/json
questions
object[]
required

List of questions for the survey

Minimum array length: 1
name
string

Survey name (1-255 characters, trimmed)

Required string length: 1 - 255
projectId

Project GUID (string) or numeric ID to associate with the survey, or null to leave unassigned. Mutually exclusive with projects.

projects
(string | number)[]

Project GUIDs (or numeric IDs) to associate the survey with. Mutually exclusive with projectId.

Maximum array length: 50
tags
object[]

Tags to attach. Each item has either id (existing tag) or name (find-or-create).

Maximum array length: 10
targeting
string[]

Demographic targeting traits

reporting
string[]

Reporting breakdown traits

country
string

Two-letter country code (e.g. US)

sampleSize
string

Number of respondents. Standard polls: "15", "30", "50", "75", "100", "200", "300", "500". Screen recording polls: "5", "10", "15", "20", "25", "30", "50", "75" (max 75).

surveyIntent
string

Original intent of the survey as interpreted by AI (max 255 characters)

Maximum string length: 255
isMiniPoll
boolean

Whether to create this survey as a daily mini-poll

Response

Default Response

success
boolean
data
object

Full survey data including questions, options, and metadata

cost
object

Cost information for the survey