Create a complaint

POST/complaints

Record staff-mediated complaint intake

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

channelstringRequired

contactstringRequired

external_refstringOptional

namestringRequired

occurred_atstring · date-time or nullOptional

productstringRequired

received_atstring · date-timeOptional

related_customer_idstringOptional

Alleged reference, never portal access authority.

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

summarystringRequired

third_partystringOptional

Returns

201 Created

The Complaint object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/complaints' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "string",
    "contact": "string",
    "name": "string",
    "product": "string",
    "summary": "string"
  }'

Response201

{
  "acknowledge_by": "2026-09-17T14:30:00Z",
  "acknowledge_escalate_at": "2026-09-17T14:30:00Z",
  "acknowledged_at": "2026-09-17T14:30:00Z",
  "assignee": "string",
  "channel": "string",
  "contact": "string",
  "created_at": "2026-09-17T14:30:00Z",
  "created_by": "string",
  "customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "escalate_at": "2026-09-17T14:30:00Z",
  "escalated_deadlines": [
    "string"
  ],
  "escalation_level": 0,
  "evidence_version": 0,
  "external_ref": "string",
  "id": "cmpl_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "name": "string",
  "occurred_at": "2026-09-17T14:30:00Z",
  "policy_id": "string",
  "product": "string",
  "public_response_ids": [
    "string"
  ],
  "published_response_id": "cprs_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "received_at": "2026-09-17T14:30:00Z",
  "related_customer_id": "cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "resolve_by": "2026-09-17T14:30:00Z",
  "revision": 0,
  "round": 0,
  "round_started_at": "2026-09-17T14:30:00Z",
  "status": "string",
  "summary": "string",
  "third_party": "string"
}