SINGLE_LINE
| MULTI_LINE
| EMAIL
| URL
| null
string
:
The globally unique ID of this object generated by Kombo.
string | null
:
The raw ID of the object in the remote system.
string | null
:
The question that you need to display.
string | null
:
Additional information provided alongside the title.
integer | null
:
Specifies the order in which the question should be displayed.
boolean | null
:
Indicates whether the question is mandatory.
string | null
:
The Kombo ID of another screening question that acts as a precondition.
array
:
Array of valid responses that trigger the display of this question.
Scope config settings in Kombo dashboard
Note: Each job’sscreening_questions
field can contain one or more questions. The order of these questions (defined by theindex
field) is recommended for display but not mandatory.
Job Application Form with Screening Questions
screening_questions
array. Depending on your product’s goal, you might consider only displaying required screening questions to minimize the candidate’s input.
format.type
and format.display_type
provided. For example:
Type | Recommended Format |
---|---|
TEXT / SINGLE_LINE | Text input |
TEXT / MULTI_LINE | Text area |
NUMBER | Numeric input field or slider |
SINGLE_SELECT / MULTI_SELECT | Radio buttons, dropdown menus, or checkboxes |
BOOLEAN | Toggle, checkbox, yes/no dropdown, or radio buttons |
DATE | Date picker or input field with format validation |
FILE | File upload control |
INFORMATION | Display a static text |
UNKNOWN | Handle custom logic as needed |
required
field is true
.
Tip: Adapt these examples to match your styling guidelines and frontend framework. Use real data from the API to populate questions dynamically.
NUMBER
questions).max_length
for text fields.Error Handling: Implement robust error handling in your integration. For instance:
- 400 Errors: Likely indicate validation issues. Alert the candidate or log the error for review.
- 500 Errors: Signal server-side issues. In these cases, prompt users to try again later and contact Kombo support if the issue persists.
Type | Answer |
---|---|
TEXT | - |
NUMBER | 0 (unless min and/or max are described, in which case we take the minimum number in the range) |
BOOLEAN | true |
SINGLE_SELECT | The first option |
MULTI_SELECT | The first option |
DATE | The current date |
FILE | An empty file |
display_type
for screening questions contain information about the display and validation. For example a screening question of type TEXT
can have an these display_type
properties: SINGLE_LINE
, MULTI_LINE
, EMAIL
and URL
. EMAIL
and URL
have additional validation rules.
precondition_question_id
is the id
of the first question, and precondition_options
includes the id
of the Yes option of the first question.