---
title: "Batch create responses"
method: POST
path: "/v3/responses/batch"
tags: ["response"]
---

# Batch create responses

`POST /v3/responses/batch`

## Request body

- BatchImportRequestSchema
  - `survey_id` number, required — ID of the survey
  - `responses` Model132[], required
    - `contact_id` number — ID of the contact
    - `contact` Contact — Contact of the submission
      - `full_name` string — Full Name of contact
      - `email` string — Email of contact. Can be optional only if anonymous contact feature is enabled.
      - `phone` string — Phone number of the contact
      - `mobile` string — Mobile number of the contact
      - `job_title` string — Job Title of the contact
      - `contact_type` 'contact' | 'employee' — Type of contact
      - `referenceId` string — Reference ID of the anonymous contact
    - `variables` Properties
    - `trigger_workflow` boolean — When true (the default), this response triggers its configured workflows — webhooks, survey rules, integrations, and notifications. Set it to false to import the response quietly, without firing any of them. We recommend sending the same value for every response in the batch. Note: marketplace (SparrowApps) events are gated at the batch level — if even one response has trigger_workflow set to false, marketplace events are skipped for the entire batch.
    - `channel_id` number — ID of the channel
    - `meta_data` MetaData
      - `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
      - `tags` string[] — Tags of response
      - `ip` string — Tags of response
      - `device_type` string — Device Type of response
      - `language` string — Language of response
    - `answers` AnswerInput[], required
      - `question_id` number, required — ID of the question
      - `parent_question_id` number — ID of the parent question
      - `answer` string, required — Answer of question
      - `other_txt` string — Other Text Answer
      - `matrix_txt` string[] — Matrix Answer for Text Input
      - `matrix_int` string[] — Matrix Answer for Rating
      - `region_code` string — Region code of Answer
      - `time` string — Time of Answer
      - `time_zone` string — TimeZone of Answer

## Response `202`

Accepted

---

[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/25b2eba467de/schema)