# Units

Operations for managing rental units

## Get units

 - [GET /units](https://rentengine.redocly.app/openapi/units/getunits.md): Retrieve units with optional filtering and pagination

## Create or update a unit

 - [POST /units](https://rentengine.redocly.app/openapi/units/postunit.md): Create a new unit or update an existing one.

## Insert vs Update
- : When no  is provided, a new unit will be created. Required fields for creation include , , , and .
- : When an  is provided, an existing unit will be updated. No other fields are required.

## Address Updates
When updating a unit, if you include the  field, you must provide all address components (, , , , ). Partial address updates are not supported.

## Structured Access Instructions
When providing , the  field must also be set. The structure of the access instructions depends on the showing method:
- For "Self Guided", "Remote Guided", or "Remote Guided with Gated Access" methods: Include fields like , , etc.
- For "Accompanied" method: Include fields like , , etc.


## Units

 - [POST UnitsEvents](https://rentengine.redocly.app/openapi/units/receive-units-updates.md): Webhook for unit changes (creates, updates, deletes).
Only the below fields are included in the record and old_record objects.