Create scorecard

post

https://harvest.greenhouse.io/v3/scorecards

Create a scorecard for a given interview kit on a given application. interview_kit_id, interviewer_id, interviewed_at, application_id, and submitter_id are required; the kit must belong to the application's job. Send status: "draft" to stash an in-progress scorecard, or status: "complete" to submit immediately — submitting stamps submitted_at and locks the scorecard outside the organization's edit window.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

interview_kit_id

integer

required

Id of the interview kit this scorecard is filled out against. Must belong to the same job as the application_id.

interviewer_id

integer

required

Id of the Greenhouse user this scorecard is assigned to (the interviewer being scored against).

interviewed_at

date-time

required

Timestamp the interview took place, in ISO 8601. Used to compute time-to-submit and to align the scorecard with the interview slot.

notes

string

Free-text "key takeaways" the interviewer is recording (pros, cons, follow-ups). Plain text; @-mentions are accepted and stored alongside the rendered names.

candidate_rating

string

enum

Overall recommendation for the candidate. One of strong_no ("Definitely Not"), no, yes, strong_yes, or no_decision. Pass no_decision to submit the scorecard without picking a recommendation.

Allowed:

private_notes

string

Free-text private notes; only users with the "see private notes" permission can read these back.

status

string

enum

Initial lifecycle status. Send draft to create an in-progress scorecard, or complete to submit it immediately — sending complete also stamps submitted_at.

Allowed:

public_notes

string

Free-text "note to other interviewers" shared with the rest of the hiring team.

application_id

integer

required

Id of the application the scorecard belongs to. The application's job must own the supplied interview_kit_id.

submitter_id

integer

required

Id of the user submitting the scorecard. Usually matches interviewer_id; set differently when an admin is filing the scorecard on the interviewer's behalf.

Responses

401

Unauthorized

403

Forbidden

422

Unprocessable Content

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Successful