---
title: "Add Client Matters"
method: POST
path: "/api/v1/client_matters"
tags: ["Add"]
---

# Add Client Matters

`POST /api/v1/client_matters`

Adds a list of client matters to Harvey. Each client matter includes a name and an optional description.

## Request body

- object
  - `client_matters` object[], required
    - `cm_name` string, required — The name of the client matter.
    - `cm_desc` string — A description of the client matter.
    - `cm_allowed` 'true' | 't' | '1' | 'false' | 'f' | '0' — Boolean-like string indicating if the client matter is allowed in Harvey.

## Response `200`

The number of successfully added client matters and the number of failures.

- object
  - `success_count` integer — The total amount of client matters that successfully uploaded.
  - `failed` string[] — A list of cm_names that failed to upload. If all uploads were successful, you will receive an empty array.

## Other responses

- `400` — Bad request.
- `401` — Unauthorized.
- `429` — Rate limit exceeded.
- `500` — Internal server error.

---

[API](https://skmtc.dev/harvey/apis/harvey-client-matter-api.md) · [All operations](https://skmtc.dev/harvey/apis/harvey-client-matter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/harvey/harvey-client-matter-api/revisions/4a9e0925d49e/schema)