---
title: "Create a deal"
method: POST
path: "/deals"
tags: ["Deal"]
---

# Create a deal

`POST /deals`

## Request

- Base URL: `https://apidocs.lwolf.com` (the document declares no server; this is the origin it was published from)
- URL: `https://apidocs.lwolf.com/deals`
- Auth: HTTP bearer

Creates a deal.

## Request body

- Deal
  - `id` string, uuid
  - `version` integer
  - `createdTimestamp` string, date-time
  - `modifiedTimestamp` string, date-time
  - `culture` string
  - `number` string
  - `mlsNumber` string
  - `statusCode` string
  - `classCode` string
  - `name` string
  - `addressStreetNumber` string
  - `addressStreetName` string
  - `addressStreetDirection` string
  - `addressUnitNumber` string
  - `addressCity` string
  - `addressProvinceCode` string
  - `addressPostalCode` string
  - `addressCountryCode` string
  - `offerDate` string, date
  - `closeDate` string, date
  - `entryDate` string, date
  - `finalizeDate` string, date
  - `firmDate` string, date
  - `closePrice` number, float
  - `legalDescription` string
  - `classification` object
    - `id` string, uuid
    - `createdTimestamp` string, date-time
    - `modifiedTimestamp` string, date-time
    - `code` string
    - `name` string
    - `endTypeCode` string
    - `endCount` string
  - `propertyType` object
    - `id` string, uuid
    - `createdTimestamp` string, date-time
    - `modifiedTimestamp` string, date-time
    - `code` string
    - `name` string
    - `shortName` string
    - `classCode` string
  - `businessContacts` unknown[]
    - unknown
  - `client-contacts` unknown[]
    - unknown
  - `conditions` unknown[]
    - unknown
  - `deposits` unknown[]
    - unknown
  - `externalAgents` unknown[]
    - unknown
  - `tiers` unknown[]
    - unknown

## Response `201`

Successfully created a deal.

- Deal
  - `id` string, uuid
  - `version` integer
  - `createdTimestamp` string, date-time
  - `modifiedTimestamp` string, date-time
  - `culture` string
  - `number` string
  - `mlsNumber` string
  - `statusCode` string
  - `classCode` string
  - `name` string
  - `addressStreetNumber` string
  - `addressStreetName` string
  - `addressStreetDirection` string
  - `addressUnitNumber` string
  - `addressCity` string
  - `addressProvinceCode` string
  - `addressPostalCode` string
  - `addressCountryCode` string
  - `offerDate` string, date
  - `closeDate` string, date
  - `entryDate` string, date
  - `finalizeDate` string, date
  - `firmDate` string, date
  - `closePrice` number, float
  - `legalDescription` string
  - `classification` object
    - `id` string, uuid
    - `createdTimestamp` string, date-time
    - `modifiedTimestamp` string, date-time
    - `code` string
    - `name` string
    - `endTypeCode` string
    - `endCount` string
  - `propertyType` object
    - `id` string, uuid
    - `createdTimestamp` string, date-time
    - `modifiedTimestamp` string, date-time
    - `code` string
    - `name` string
    - `shortName` string
    - `classCode` string
  - `businessContacts` unknown[]
    - unknown
  - `client-contacts` unknown[]
    - unknown
  - `conditions` unknown[]
    - unknown
  - `deposits` unknown[]
    - unknown
  - `externalAgents` unknown[]
    - unknown
  - `tiers` unknown[]
    - unknown

## Other responses

- `400`: Invalid request. See response body for details.
- `401`: Unauthorized request. See response body for details.
- `403`: Permission denied. See response body for details.
- `409`: Deal already exists.
- `500`: Unknown error. See response body for details.

---

[API](https://skmtc.dev/lwolf/apis/deals-api.md) · [All operations](https://skmtc.dev/lwolf/apis/deals-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lwolf/apis/deals-api/revisions/edf6d7aeccfe?raw)