API-only custom application question


Custom application questions allow your organization to collect information from candidates when they are applying to a job. Candidate responses to custom application questions can subsequently be viewed and configured for reporting purposes.

Every custom application question can be configured to meet varying privacy concern your organization may have. Custom application questions can be configured with one of the following privacy settings:

In this article, we will provide an overview of API Only custom application question and how to add an API Only custom application question to an existing job post.


API Only Custom Application Question Overview

API Only is generally considered the most restrictive privacy setting your organization can assign to a custom application question. When a question is marked as API Only, candidate responses to the question will not surface in the Greenhouse Recruiting application and can only be viewed via the Greenhouse API.

Greenhouse Recruiting assumes that there are fewer users who have access to your organization's API than who have the Can see private notes, salary info, manage offers, and approve jobs/offers permission. This more restrictive privacy setting can be useful for certain candidate information that you do not want surfaced in Greenhouse Recruiting:

Use Case: The API Only setting for custom application questions can be useful if your organization plans to ask its own EEOC or demographic questions instead of using Greenhouse Recruiting's default questions. Answers to these questions are obviously very sensitive and you can use the API Only setting to restrict response visibility within the app and in a candidate export.

Note: Responses to API Only custom application questions will still populate in the Greenhouse Business Intelligence Connector.


Add API Only Custom Application Question 

To add an API Only custom application question to an existing job post, click All Jobs from the navigation bar and select a job from the subsequent list.


Click Job Setup and navigate to Job Posts on the left-hand panel.


Navigate to a job post and click the Edit icon edit.png inline with the job post name.


Navigate to Custom Application Questions and click Add Custom Question.


From the subsequent dialog box, input the necessary information for the custom application question. Select API Only from the Privacy section.

Click Add when finished.

Note: Once a custom application question's privacy setting is marked and saved as API Only it cannot be changed.


Navigate down the Edit Your Job Post page and click Save to confirm the change.