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

# Create Consumer Dispute

`POST /v2/consumers/{consumer_external_id}/disputes/`

## Path parameters

- `consumer_external_id` 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-09-29** `9ae55ff0d84c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/upwardli/apis/api-reference/changes/v2/consumers/:consumer_external_id/disputes/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.dev/upwardli/apis/api-reference/revisions/9ae55ff0d84c?raw)