---
title: "Create matter"
method: POST
path: "/matters/v1"
tags: ["Matters"]
---

# Create matter

`POST /matters/v1`

Create a new legal matter and optionally link an existing primary vault.

## Request body

- object
  - `title` string, required
  - `display_id` string
  - `description` string
  - `status` 'intake' | 'open' | 'pending' | 'closed' | 'archived'
  - `matter_type` string
  - `practice_area` string
  - `subtype` string
  - `client_party_id` string, nullable
  - `client_name` string
  - `responsible_attorney_id` string
  - `jurisdiction` object
  - `important_dates` object
  - `billing` object
  - `metadata` object
  - `custom_fields` object
  - `vault_id` string
  - `vault` object
    - `description` string
    - `enableGraph` boolean
    - `enableIndexing` boolean
    - `metadata` object

## Response `201`

Matter created

## Other responses

- `400` — Invalid matter payload
- `401` — Invalid API key
- `403` — Insufficient permissions
- `404` — Organization or responsible attorney not found
- `409` — display_id already exists

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/revisions/5b7e64e6d6f9/schema)