Zendesk

Zendesk Satisfaction Reasons API

The Zendesk Satisfaction Reasons API lets you programmatically manage the predefined list of reasons customers can choose when they leave a bad satisfaction rating on a ticket. With it, admins can list, create, update, reorder, activate/deactivate, and delete reasons that appear in the followup survey, ensuring the choices align with current operations or policies.

GitHub OpenAPI

Documentation

📖
Documentation
https://developer.zendesk.com/api-reference/ticketing/ticket-management/satisfaction_reasons/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/zendesk/refs/heads/main/openapi/satisfaction-reasons-openapi-original.yml

OpenAPI Specification

satisfaction-reasons-openapi-original.yml Raw ↑ 
openapi: 3.1.0
info:
  version: "1.0"
  title: Zendesk Satisfaction Reasons
  description: Needs a description.
paths:
  /api/v2/satisfaction_reasons:
    get:
      operationId: ListSatisfactionRatingReasons
      tags:
        - Satisfaction Reasons
      summary: Zendesk Get  Api V2 Satisfaction_reasons
      description: |
        List all reasons for an account

        #### Allowed For

        * Admins
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SatisfactionReasonsResponse'
              examples:
                default:
                  $ref: '#/components/examples/SatisfactionReasonsResponseExample'
  /api/v2/satisfaction_reasons/{satisfaction_reason_id}:
    get:
      operationId: ShowSatisfactionRatings
      tags:
        - Satisfaction Reasons
      summary: Zendesk Get  Api V2 Satisfaction_reasons Satisfaction_reason_id
      description: |
        #### Allowed For

        * Admins
      parameters:
        - name: satisfaction_reason_id
          in: path
          description: The id of the satisfaction rating reason
          required: true
          schema:
            type: integer
          example: 35121
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SatisfactionReasonResponse'
              examples:
                default:
                  $ref: '#/components/examples/SatisfactionReasonResponseExample'
components:
  schemas:
    SatisfactionReasonsResponse:
      type: object
      properties:
        reasons:
          type: array
          items:
            $ref: '#/components/schemas/SatisfactionReasonObject'
    SatisfactionReasonResponse:
      type: object
      properties:
        reason:
          type: array
          items:
            $ref: '#/components/schemas/SatisfactionReasonObject'
tags:
  - name: Satisfaction Reasons