---
title: "Start a new response"
method: POST
path: "/v3/responses/new"
tags: ["response"]
---

# Start a new response

`POST /v3/responses/new`

Partial submission settings for the survey must be enabled to use this endpoint

## Request body

- StartResponseSchema
  - `survey_id` number, required — ID of the survey
  - `contact_id` number — ID of the contact
  - `channel_id` number — ID of the channel
  - `meta_data` Model133
    - `os` string — OS of the response
    - `browser` string — Browser of response
    - `time_zone` string — Time Zone of response
    - `browser_language` string — Browser Language of the response
    - `date_time` string, date — Date and Time of submission. Should be in the ISO format

## Response `200`

Successful

---

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