---
title: "Create Consumer Dispute"
method: POST
path: "/v2/consumers/{consumer_id}/dispute/"
tags: ["consumers"]
---

# Create Consumer Dispute

`POST /v2/consumers/{consumer_id}/dispute/`

## Path parameters

- `consumer_id` string, required

## Headers

- `Authorization` string, required

## Request body

- ConsumerDispute
  - `pk` integer
  - `reason` string, required
  - `details` string, nullable
  - `status` 'in_review' | 'submitted' | 'closed' | 'user_canceled'
  - `created_at` string, date-time

## Response `201`

- ConsumerDispute
  - `pk` integer
  - `reason` string, required
  - `details` string, nullable
  - `status` 'in_review' | 'submitted' | 'closed' | 'user_canceled'
  - `created_at` string, date-time

## Changes

- **2026-08-22** `8a237f1f704f` — 1 warning
  - the `reason` request property's maxLength was set to `200`

[Change history](https://skmtc.dev/upwardli/apis/api-reference/changes/v2/consumers/:consumer_id/dispute/post.md)

---

[API](https://skmtc.dev/upwardli/apis/api-reference.md) · [All operations](https://skmtc.dev/upwardli/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/upwardli/api-reference/revisions/8a237f1f704f/schema)