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

FieldTypeRequiredDescription
keystringnoClient-defined identifier. Required when referenced by quotas.
textstringyesThe question text shown to participants.
pickstringyesQuestion type: one, any, or boolean.
answersarrayyesTwo or more answer options.
answers[].textstringyesThe answer text shown to participants.
answers[].qualify_logicstringyesQualification behavior: may, must, must_one_of, or reject.

Question Types

pickDescription
oneSingle select -- participant picks exactly one
anyMulti select -- participant picks one or more
booleanYes / No

Qualify Logic

ValueMeaning
mayDoes not affect qualification
mustParticipant must select this answer (only valid with pick: "one")
must_one_ofAt least one answer in this group must be selected
rejectSelecting this disqualifies the participant

Note: must qualify_logic is only valid with pick: "one". For multi-select questions (pick: "any"), use must_one_of instead. The API returns a BAD_REQUEST error if must is used with pick: "any".