Screening Questions
Define multi-option screening questions to qualify or disqualify participants during application.
Screening questions are explicit multi-option questions asked to participants during application. They should be designed so that the qualifying answer is not obvious.
Example
[
{
"key": "role_type",
"text": "Which best describes your current role?",
"pick": "one",
"answers": [
{ "text": "Individual contributor", "qualify_logic": "may" },
{ "text": "People manager", "qualify_logic": "may" },
{ "text": "Executive / C-suite", "qualify_logic": "may" },
{ "text": "Not currently employed", "qualify_logic": "reject" }
]
},
{
"key": "facility_size",
"text": "What is the approximate total square footage of facilities you currently oversee?",
"pick": "one",
"answers": [
{ "text": "I don't manage any facilities", "qualify_logic": "reject" },
{ "text": "Under 10,000 sqft", "qualify_logic": "reject" },
{ "text": "10,000 - 50,000 sqft", "qualify_logic": "may" },
{ "text": "50,001 - 100,000 sqft", "qualify_logic": "may" },
{ "text": "100,001 - 500,000 sqft", "qualify_logic": "must_one_of" },
{ "text": "Over 500,000 sqft", "qualify_logic": "must_one_of" }
]
},
{
"key": "team_size",
"text": "How many direct reports do you have?",
"pick": "one",
"answers": [
{ "text": "1-5", "qualify_logic": "may" },
{ "text": "6-15", "qualify_logic": "may" },
{ "text": "16-50", "qualify_logic": "may" },
{ "text": "Over 50", "qualify_logic": "may" }
]
}
]The key field is a client-defined identifier for the question. It is required when the question is referenced by a quota.
Question Fields
| Field | Type | Required | Description |
|---|---|---|---|
key | string | no | Client-defined identifier. Required when referenced by quotas. |
text | string | yes | The question text shown to participants. |
pick | string | yes | Question type: one, any, or boolean. |
answers | array | yes | Two or more answer options. |
answers[].text | string | yes | The answer text shown to participants. |
answers[].qualify_logic | string | yes | Qualification behavior: may, must, must_one_of, or reject. |
Question Types
pick | Description |
|---|---|
one | Single select -- participant picks exactly one |
any | Multi select -- participant picks one or more |
boolean | Yes / No |
Qualify Logic
| Value | Meaning |
|---|---|
may | Does not affect qualification |
must | Participant must select this answer (only valid with pick: "one") |
must_one_of | At least one answer in this group must be selected |
reject | Selecting this disqualifies the participant |
Note:
mustqualify_logic is only valid withpick: "one". For multi-select questions (pick: "any"), usemust_one_ofinstead. The API returns aBAD_REQUESTerror ifmustis used withpick: "any".