---
title: "Create scorecard question answer"
method: POST
path: "/v3/scorecard_question_answers"
tags: ["Scorecard Question Answers"]
deprecated: true
---

# Create scorecard question answer

`POST /v3/scorecard_question_answers`

## Request

- Base URL: `https://harvest.greenhouse.io`
- URL: `https://harvest.greenhouse.io/v3/scorecard_question_answers`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.greenhouse.io/authorize`
    - Client credentials
    - Token URL: `https://auth.greenhouse.io/token` scopes: `harvest:scorecard_question_answers:create`
  - HTTP bearer

> **Deprecated.**

**Deprecated** — where available, prefer the nested `question_answers` array on `POST`/`PATCH /v3/scorecards`, which writes answers atomically with the scorecard and supports every answer type including `single_select`. This endpoint remains fully supported for existing integrations. Create one interviewer response to one scorecard question. Use this to attach a `text` answer (via `answer`) or a `yes_no` answer (via `boolean_value`) to an existing scorecard; for `single_select` / `multi_select` questions, create the row here with `answer` and `boolean_value` left blank, then add option selections through the `scorecard_question_answer_options` endpoint.

## Request body

- object
  - `scorecard_id` integer, required: Id of the scorecard to attach this answer to. The scorecard must belong to your organization and the requesting user must have permission to edit it.
  - `scorecard_question_id` integer, required: Id of the `scorecard_question` being answered. Must reference a question on the same `interview_kit` as the target scorecard; the question's `answer_type` determines which of `answer` or `boolean_value` is meaningful (`single_select` / `multi_select` answers are created via the `scorecard_question_answer_options` endpoint).
  - `answer` string, nullable: Free-text response for `text`-type questions. Send `null` or an empty string to record "no answer". Ignored for `yes_no`, `single_select`, and `multi_select` questions.
  - `boolean_value` boolean, nullable: Response for `yes_no`-type questions: `true` for yes, `false` for no, `null` to leave blank. Rejected with a 422 if the referenced question's `answer_type` is not `yes_no`.

## Response `201`

Successful

- object
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `scorecard_id` integer: Id of the scorecard this answer belongs to. Every answer is tied to exactly one scorecard, which in turn belongs to a single interviewer's submission on one application.
  - `scorecard_question_id` integer: Id of the `scorecard_question` this answer responds to. The question's `answer_type` (`text`, `yes_no`, `single_select`, `multi_select`) determines which field on the answer is populated: `text` uses `answer`, `yes_no` uses `boolean_value`, and `single_select`/`multi_select` use the `scorecard_question_answer_options` sub-resource.
  - `answer` string, nullable: Free-text response for `text`-type scorecard questions. Plain text — HTML formatting and `@`-mention markup are stripped. `null` (or empty string) when the question is `yes_no`, `single_select`, or `multi_select`, or when the interviewer declined to answer.
  - `answer_with_tags` string, nullable: HTML-formatted version of `answer`, preserving rich-text formatting (bold, italic, etc.) and `@`-mentions as embedded user tags (e.g. `@[User Name](user:123)`). `null` when there is no formatting or markup to preserve (i.e. when the stored value would be identical to `answer`), and under the same conditions as `answer`.
  - `boolean_value` boolean, nullable: Response for `yes_no`-type scorecard questions: `true` for yes, `false` for no, `null` when the question is not `yes_no` or when the interviewer left it blank. Ignored on writes for any question whose `answer_type` is not `yes_no`.
  - `value` union: Read-only. The answer in the same vocabulary the nested write path accepts (`question_answers[].value` on `POST`/`PATCH /v3/scorecards`), dispatched on the question's `answer_type`: string for `text`, boolean for `yes_no`, the selected option id for `single_select`, an array of selected option ids for `multi_select`. `null` when unanswered.
    - string
    - boolean
    - integer
    - integer[]

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Content

---

[API](https://skmtc.dev/greenhouse/apis/harvest-api.md) - [All operations](https://skmtc.dev/greenhouse/apis/harvest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greenhouse/apis/harvest-api/revisions/822822e3f771?raw)