---
title: "Configure cancel survey"
method: POST
path: "/subscriptions/cancelSurvey/response"
tags: ["Subscriptions"]
---

# Configure cancel survey

`POST /subscriptions/cancelSurvey/response`

Creates or updates a cancel survey for a subscription.

Either `reasonId` or `reasonName` can be provided, but `reasonId` takes precedence.

## Request body

- object
  - `subscription` string, required — Unique ID of the subscription for which the survey is submitted.
  - `cancelSurvey` object, required
    - `reasonId` '1' | '2' | '3' | '4' | '5' | '6' | '7', required — ID of the cancel reason selected during cancellation. If `reasonId` is provided, it overrides `reasonName`. Each ID corresponds to a predefined system reason name: - 1 – cost - 2 – need - 3 – usability - 4 – support - 5 – integration - 6 – alternative - 7 – other
    - `reasonName` 'cost' | 'need' | 'usability' | 'support' | 'integration' | 'alternative' | 'other' — Optional. Used only if `reasonId` is not provided. Must exactly match a valid reason name.
    - `feedbackText` string — Optional freeform feedback submitted by the user.
    - `lang` 'ar' | 'cs' | 'da' | 'de' | 'es' | 'fi' | 'fr' | 'hr' | 'hu' | 'it' | 'iw' | 'ja' | 'ko' | 'nl' | 'no' | 'pl' | 'pt' | 'ru' | 'sk' | 'sv' | 'tr' | 'zh' — Language code used for localizing cancel reason fields.

## Response `200`

OK

- object
  - `id` string — Unique identifier for the cancel survey record.
  - `reasonId` string — The cancel reason ID that was saved.
  - `name` string — Predefined name for the cancel reason.
  - `displayName` string — Label shown to the user in the cancel survey.
  - `description` string — Long-form explanation of the cancel reason.
  - `feedbackText` string — User-submitted feedback captured during the cancellation.
  - `lang` string — Language code used when the cancel survey was submitted.

## Other responses

- `401` — Authentication credentials are missing or invalid.
- `429` — Rate limit exceeded. Retry after the number of seconds specified in the Retry-After header.
- `500` — Internal server error.

---

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