---
title: "Create a survey"
method: POST
path: "/api/satisfaction-surveys"
tags: ["Satisfaction Surveys"]
---

# Create a survey

`POST /api/satisfaction-surveys`

Create a new satisfaction survey. If you don't want the satisfaction survey to be sent by Gorgias set `should_send_datetime` parameter to `null`.

## Request body

- object
  - `body_text` string, nullable — The comment sent by the customer.
  - `created_datetime` string, date-time, nullable — When the survey was created.
  - `customer_id` integer, required — The ID of the customer who filled the survey.
  - `meta` object, nullable — Data associated with the satisfaction survey. You can use this parameter to store structured information (key-value data) about the satisfaction survey. This field is not used by Gorgias.
  - `score` integer, nullable — The level of satisfaction. Scores range from 1 to 5.
  - `scored_datetime` string, date-time, nullable — When the survey was filled by the customer.
  - `sent_datetime` string, date-time, nullable — When the survey was sent. If is not set it means that it was not sent yet.
  - `should_send_datetime` string, date-time, nullable — When the survey should be sent. If not set then the survey will not be sent by Gorgias.
  - `ticket_id` integer, required — The ID of the ticket the survey is associated with.

## Response `201`

The created satisfaction survey.

- SatisfactionSurvey — Satisfaction surveys are one of the best ways to determine how well your team is supporting your customers. Find out more about how to use them here: https://docs.gorgias.com/survey/customer-satisfaction-survey Currently there can be only one satisfaction survey per ticket.
  - `id` integer — ID of the survey.
  - `body_text` string, nullable — The comment sent by the customer.
  - `created_datetime` string, date-time, nullable — When the survey was created.
  - `customer_id` integer — The ID of the customer who filled the survey.
  - `meta` object, nullable — Data associated with the satisfaction survey. You can use this parameter to store structured information (key-value data) about the satisfaction survey. This field is not used by Gorgias.
  - `score` integer, nullable — The level of satisfaction. Scores range from 1 to 5.
  - `scored_datetime` string, date-time, nullable — When the survey was filled by the customer.
  - `sent_datetime` string, date-time, nullable — When the survey was sent. If is not set it means that it was not sent yet.
  - `should_send_datetime` string, date-time, nullable — When the survey should be sent. If not set then the survey will not be sent by Gorgias.
  - `ticket_id` integer — The ID of the ticket the survey is associated with.
  - `uri` string — URI of the survey.

---

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