---
title: "Create Transaction"
method: POST
path: "/transactions"
tags: ["Transactions"]
---

# Create Transaction

`POST /transactions`

## Request

- Base URL: `https://ws.zipformplus.com/api`
- URL: `https://ws.zipformplus.com/api/transactions`
- Auth: API key in header `X-Auth-ContextId`

Creates a new transaction for the authenticated user. `name` is required. `data` can include key-value pairs from the Transaction Data Keys appendix. `transactionType` and `propertyType` accept string or integer enum values.

## Request body

- object
  - `name` string, required
  - `status` string
  - `transactionType` 'Listing' | 'Purchase' | 'Lease' | 'LeaseListing': Integer values: Listing=0, Purchase=1, Lease=2, LeaseListing=3
  - `propertyType` 'Residential' | 'Commercial' | 'Industrial' | 'VacantLand' | 'MultiUnit' | 'FarmAndRanch' | 'Condominium' | 'ManufacturedHome' | 'Coop' | 'Unlisted': Integer values: Residential=0, Commercial=1, Industrial=2, VacantLand=3, MultiUnit=4, FarmAndRanch=5, Condominium=6, ManufacturedHome=7, Coop=8, Unlisted=9
  - `data` object: Key-value pairs of transaction data. See Transaction Data Keys in the introduction.

## Response `201`

Transaction created successfully

- Transaction
  - `id` string, uuid: Transaction GUID
  - `name` string
  - `status` 'active' | 'pending' | 'closed' | 'inactive' | 'locked'
  - `expiration` string, date-time
  - `transactionType` 'Listing' | 'Purchase' | 'Lease' | 'LeaseListing'
  - `propertyType` 'Residential' | 'Commercial' | 'Industrial' | 'VacantLand' | 'MultiUnit' | 'FarmAndRanch' | 'Condominium' | 'ManufacturedHome' | 'Coop' | 'Unlisted'
  - `hasFiles` boolean
  - `created` string, date-time
  - `lastUpdated` string, date-time
  - `ownerName` string
  - `number` integer
  - `seller` string
  - `buyer` string
  - `propertyAddress` string: Full address in one value
  - `address` string
  - `city` string
  - `state` string
  - `zip` string
  - `isSigned` boolean: Whether the transaction has signed documents
  - `EncryptedOwnerId` string, uuid: GUID of the agent who owns this transaction

## Other responses

- `401`: Unauthorized

---

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