---
title: "Create a transaction"
method: POST
path: "/transact-workflow/v1/Transactions"
tags: ["Transactions"]
---

# Create a transaction

`POST /transact-workflow/v1/Transactions`

## Request

- Base URL: `https://api.lwolf.com`
- URL: `https://api.lwolf.com/transact-workflow/v1/Transactions`
- Auth: HTTP bearer and API key in header `lw-subscription-key`

Creates a new transaction for the user specified in the request body.

## Request body

- TransactionCreate: Payload for creating a new transaction.
  - `userId` string, uuid, required: GUID of the user creating the transaction.
  - `type` integer: Transaction type code. Observed value: `1`. **TODO: document the full list of code values and their meanings.**
  - `address1` string: Property street address, line 1.
  - `address2` string: Property street address, line 2.
  - `address3` string: Property street address, line 3 (e.g. unit number).
  - `address4` string: Property street address, line 4.
  - `locality` string: City / locality.
  - `region` string: State or province code.
  - `subRegion` string: County or sub-region.
  - `postalCode` string: Postal / ZIP code.
  - `country` string: Country.
  - `legalDescription` string: Legal description of the property.
  - `propertyIncludes` string: Items included with the property.
  - `propertyExcludes` string: Items excluded from the property.
  - `taxNumber` string: Property tax number.
  - `mlsNumber` string: MLS listing number.
  - `note` string: Free-form note.
  - `schoolDistrict` string: School district.
  - `zoningClass` string: Zoning classification.
  - `yearBuilt` integer: Year the property was built.
  - `phase` integer: Transaction phase code. Observed value: `1`. **TODO: document the full list of code values and their meanings.**
  - `propertyType` integer: Property type code. Observed value: `0`. **TODO: document the full list of code values and their meanings.**
  - `asking` number: Asking price.
  - `deposit` number: Deposit amount.
  - `taxes` number: Annual taxes.
  - `closingDate` string, date-time: Closing date.
  - `listingExpiration` string, date-time: Listing expiration date.
  - `listingGoesLive` string, date-time: Date the listing goes live.

## Response `201`

Transaction created.

## Other responses

- `400`: The request is malformed or contains invalid parameters.
- `401`: The access token is missing, invalid, or expired.
- `403`: The caller is not permitted to perform this operation.
- `404`: The requested resource does not exist.

---

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