---
title: "Create a property"
method: POST
path: "/v1/properties"
tags: ["Properties"]
---

# Create a property

`POST /v1/properties`

## Request

- Base URL: `https://api.frihet.io`
- URL: `https://api.frihet.io/v1/properties`
- Auth: API key in header `X-API-Key`

## Request body

- PropertyCreate
  - `name` string, required: Property name
  - `type` 'Apartment' | 'Villa' | 'Studio' | 'House' | 'Room'
  - `address` string
  - `status` 'Active' | 'Maintenance' | 'Inactive'
  - `ownerName` string
  - `ownerEmail` string, email
  - `commissionRate` number: Commission percentage (0-100)
  - `licenseNumber` string: Tourism license number
  - `maxGuests` integer

## Response `201`

Property created

- Property
  - `id` string
  - `name` string
  - `type` string
  - `address` string
  - `status` 'Active' | 'Maintenance' | 'Inactive'
  - `ownerName` string
  - `ownerEmail` string, nullable
  - `commissionRate` number
  - `licenseNumber` string, nullable
  - `maxGuests` integer
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400`: Bad request - invalid parameters or request body
- `401`: Authentication required or invalid API key

---

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