# Create Transaction

**POST /transactions**

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.


## Servers
- Production: https://ws.zipformplus.com/api (Production)
- Staging/QA: https://api.pre.zipformplus.com/api (Staging/QA)


## Authentication methods
- Context auth


## Parameters



### Body: application/json (object)

- **name** (string)

- **status** (string)

- **transactionType** (string)
  Integer values: Listing=0, Purchase=1, Lease=2, LeaseListing=3

- **propertyType** (string)
  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.



## Responses
### 201
Transaction created successfully

#### Body: application/json (object)
- **id** (string(uuid))
  Transaction GUID

- **name** (string)

- **status** (string)

- **expiration** (string(date-time))

- **transactionType** (string)

- **propertyType** (string)

- **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


### 401
Unauthorized


[Powered by Bump.sh](https://bump.sh)