v1

latestOpenAPI 3.1.02026-07-24111290748.0 KB

Satisfaction Surveys

Create a survey

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.

post/api/satisfaction-surveys

Request body

body_textstring nullable

The comment sent by the customer.

created_datetimestring date-time nullable

When the survey was created.

customer_idinteger required

The ID of the customer who filled the survey.

metaobject 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.

scoreinteger nullable

The level of satisfaction. Scores range from 1 to 5.

scored_datetimestring date-time nullable

When the survey was filled by the customer.

sent_datetimestring date-time nullable

When the survey was sent. If is not set it means that it was not sent yet.

should_send_datetimestring date-time nullable

When the survey should be sent. If not set then the survey will not be sent by Gorgias.

ticket_idinteger required

The ID of the ticket the survey is associated with.

Example request

{
  "body_text": "Such speed, much pertinent.",
  "created_datetime": "2019-11-16T15:59:41.966927",
  "customer_id": 120,
  "meta": {
    "externalData": {
      "id": 1234
    }
  },
  "score": 2,
  "scored_datetime": "2019-11-25T15:59:41.966927",
  "sent_datetime": "2019-11-23T15:59:41.966927",
  "should_send_datetime": "2019-11-23T15:59:41.966927",
  "ticket_id": 12
}

Response

The created satisfaction survey.

idinteger

ID of the survey.