---
title: "Create response"
method: POST
path: "/api/v1/surveys/{survey_id}/responses/"
tags: ["surveys"]
---

# Create response

`POST /api/v1/surveys/{survey_id}/responses/`

Create a Response for a survey.

## Path parameters

- `survey_id` string, required

## Headers

- `Authorization` string, required

## Request body

- SurveyResponseIn — The model used to create a `Response`.
  - `participant_id` string, required — The Prolific participant ID.
  - `sections` SurveyResponseSection[] — An array of sections from the survey, otherwise use `questions`.
    - `questions` SurveyQuestionResponse[], required — The questions for a given section.
      - `answers` SurveyResponseAnswer[], required — The answers selected.
        - `answer_id` string, uuid, required — The answer ID.
        - `value` string, required — The answer option value selected.
      - `question_id` string, uuid, required — The question ID.
      - `question_title` string, required — The title of the survey question.
    - `section_id` string, uuid, required — The section ID.
  - `questions` SurveyQuestionResponse[] — An array of questions from the survey, otherwise use `sections`.
    - `answers` SurveyResponseAnswer[], required — The answers selected.
      - `answer_id` string, uuid, required — The answer ID.
      - `value` string, required — The answer option value selected.
    - `question_id` string, uuid, required — The question ID.
    - `question_title` string, required — The title of the survey question.
  - `submission_id` string, required — The Prolific submission ID.

## Response `201`

Successful Response

- SurveyResponseOut — The model used to create a serialised representation a `Response`.
  - `_id` string
  - `date_created` string, date-time — The date/time the response was created (UTC).
  - `date_modified` string, date-time — The date/time the response was modified (UTC).
  - `participant_id` string, required — The Prolific participant ID.
  - `sections` SurveyResponseSection[] — An array of sections from the survey, otherwise `questions`.
    - `questions` SurveyQuestionResponse[], required — The questions for a given section.
      - `answers` SurveyResponseAnswer[], required — The answers selected.
        - `answer_id` string, uuid, required — The answer ID.
        - `value` string, required — The answer option value selected.
      - `question_id` string, uuid, required — The question ID.
      - `question_title` string, required — The title of the survey question.
    - `section_id` string, uuid, required — The section ID.
  - `questions` SurveyQuestionResponse[] — An array of questions from the survey, otherwise `sections`.
    - `answers` SurveyResponseAnswer[], required — The answers selected.
      - `answer_id` string, uuid, required — The answer ID.
      - `value` string, required — The answer option value selected.
    - `question_id` string, uuid, required — The question ID.
    - `question_title` string, required — The title of the survey question.
  - `submission_id` string, required — The Prolific submission ID.

## Other responses

- `400` — Error

---

[API](https://skmtc.net/prolific/apis/api-reference.md) · [All operations](https://skmtc.net/prolific/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prolific/api-reference/versions/dc6f073a9827/schema)