# Create a case

**POST /case**

Creates a case in the organization from the `organization` header and returns it with its members and pending invitations. The caller becomes the case owner.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters
### Headers

- **organization** (string)
  id of the selected (active) organization




### Body: application/json (object)

- **custodianEmail** (string)

- **custodianName** (string)

- **custodianPhone** (string)

- **sendEmail** (boolean)

- **label** (string)

- **allowShareAll** (boolean)
  Use config instead

- **config** (object)

- **requestedSources** (array[string])

- **dueDate** (string)

- **sendReminders** (object)

- **metadata** (object)

- **watchlist** (boolean)

- **ocRequired** (boolean)
  OC cases only: when false, the OL creates/keeps this code without the opposing-council approval gate (code stays `na`, immediately usable, and the custodian email is sent). Ignored on non-OC cases. Defaults to true (gate on).

- **paymentRequired** (boolean)
  Whether payment is required for this extraction code

- **paymentAmount** (number)
  Payment amount in cents

- **paymentCurrency** (string)
  Payment currency (defaults to usd)

- **paymentSuccessRedirectUrl** (string)
  Payment success redirect URL

- **productName** (string)
  Product name

- **prepaidItems** (array[object])
  Prepaid basket. Each entry becomes its own Stripe line item and grants units on payment. Prices are negotiable — unitAmountCents is what the customer is charged, and is never validated against the catalog default.

- **name** (string)

- **description** (string)

- **matterId** (string)
  The firm's own client/matter reference. Printed on Stripe invoice line items and carried in invoice metadata.

- **tags** (array[string])

- **status** (string)

- **priority** (string)

- **isDefault** (boolean)

- **createExtractionCode** (boolean)

- **addExistingUsersToCase** (boolean)

- **addExistingUsersAccessLevel** (string)

- **users** (array[object])



## Responses
### 201


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)