---
title: "V1 Create Deal"
method: POST
path: "/api/v1/deals"
tags: ["public-api"]
---

# V1 Create Deal

`POST /api/v1/deals`

## Request

- Base URL: `https://api.general.legal`
- URL: `https://api.general.legal/api/v1/deals`
- Auth: HTTP bearer

Open a matter from a written request.

## Headers

- `authorization` string, nullable

## Request body

- ClientRequestDealBody
  - `initial_request` string, required
  - `deal_name` string, nullable
  - `slack_channel_id` string, nullable

## Response `200`

Successful Response

- DealCreated
  - `deal_id` union, required
    - string, uuid
    - string
  - `deal_name` string, nullable
  - `status` string, nullable
  - `initial_request` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/general/apis/general-legal-api.md) - [All operations](https://skmtc.dev/general/apis/general-legal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/general/apis/general-legal-api/revisions/4a9709568945?raw)