Skip to main content
POST
Create a screener question

Supported question types

rank and matrix are enabled per organization. Creating one without the corresponding feature enabled for your organization returns 403 Forbidden. For matrix, qualifying logic is defined per row via matrixRows (with matrixSelectionMode and matrixMatchType); see the request schema below for the full shape.

Headers

x-api-key
string
required
x-api-secret
string
required

Path Parameters

projectId
string
required

Body

application/json
text
string
required
questionType
enum<string>
default:radio
required
Available options:
radio
answers
object[]
required
isRequired
boolean
skipLogic
boolean
includeOtherOption
boolean

Response

201 - application/json
uid
string
required
text
string
required
isEnd
enum<boolean>
required

Always false on real questions. See EndOfSurveyScreenerQuestion for the auto-generated end-of-screener sentinel.

Available options:
false
answers
object[]
required

The options a participant chooses between. Always present; an empty array for question types that have no options (singleLineTextbox, multiLineTextbox, numericBox, sliderScale).

questionType
enum<string>
required
Available options:
radio
id
string
required
createdAt
string

May be absent on questions created before 2021, which predate timestamps.

updatedAt
string
isRequired
boolean
skipLogic
boolean
includeOtherOption
boolean
logic
object
order
number
randomizeOrder
boolean
warnings
string[]
Last modified on July 30, 2026