---
title: "Create a response"
method: POST
path: "/responses"
tags: ["responses"]
---

# Create a response

`POST /responses`

Creates a response in the database.

## Request body

- object
  - `createdAt` string
  - `updatedAt` string
  - `environmentId` string, required
  - `surveyId` string, required
  - `userId` string, nullable
  - `displayId` string, nullable
  - `singleUseId` string, nullable
  - `finished` boolean, required
  - `endingId` string, nullable
  - `language` string
  - `data` object, required
  - `variables` object
  - `ttc` object
  - `meta` object
    - `source` string
    - `url` string
    - `userAgent` object
      - `browser` string
      - `device` string
      - `os` string
    - `country` string
    - `action` string

## Response `201`

Response created successfully.

- Response
  - `id` string, required — The ID of the response
  - `createdAt` string, required — The date and time the response was created
  - `updatedAt` string, required — The date and time the response was last updated
  - `finished` boolean, required — Whether the response is finished
  - `surveyId` string, required — The ID of the survey
  - `contactId` string, nullable, required — The ID of the contact
  - `endingId` string, nullable, required — The ID of the ending
  - `data` object, required — The data of the response
  - `variables` object, required — The variables of the response
  - `ttc` object, required — The TTC of the response
  - `meta` object, required — The meta data of the response
    - `source` string — The source of the response
    - `url` string — The URL of the response
    - `userAgent` object
      - `browser` string
      - `os` string
      - `device` string
    - `country` string
    - `action` string
  - `contactAttributes` object, nullable, required — The attributes of the contact
  - `singleUseId` string, nullable, required — The single use ID of the response
  - `language` string, nullable, required — The language of the response
  - `displayId` string, nullable, required — The display ID of the response

---

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