---
title: "Create place"
method: POST
path: "/places"
tags: ["Places"]
---

# Create place

`POST /places`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/places`
- Auth: HTTP bearer

## Request body

- CreatePlace
  - `name` string, required
  - `type_id` string, uuid, required
  - `country_id` string, uuid, required
  - `owner_id` string, uuid, required
  - `country` string, required
  - `address_complement` string, nullable
  - `street_number` string, nullable
  - `street_name` string, required
  - `locality` string, nullable
  - `postal_code` string, required
  - `city` string, required
  - `postal_box` string, nullable
  - `latitude` number, nullable
  - `longitude` number, nullable
  - `description` string, nullable
  - `digicode` string, nullable
  - `number_of_floor` integer, nullable
  - `place_category` string, required
  - `legal_regime` string, required
  - `construction_date` string, date-time, nullable
  - `renovation_date` string, date-time, nullable

## Response `201`

Created

- Place
  - `id` string, uuid, nullable
  - `name` string, nullable
  - `country` string, nullable
  - `address_complement` string, nullable
  - `street_number` string, nullable
  - `street_name` string, nullable
  - `locality` string, nullable
  - `postal_code` string, nullable
  - `city` string, nullable
  - `postal_box` string, nullable
  - `latitude` number, nullable
  - `longitude` number, nullable
  - `description` string, nullable
  - `type_id` string, uuid, nullable
  - `country_id` string, uuid, nullable
  - `digicode` string, nullable
  - `number_of_floor` integer, nullable
  - `owner_id` string, uuid, nullable
  - `previous_owner_id` string, uuid, nullable
  - `construction_date` string, date-time, nullable
  - `renovation_date` string, date-time, nullable
  - `place_category` 'Individual' | 'Collective': Place category (individual or collective)
  - `legal_regime` 'MonoPropriete' | 'Copropriete': Legal regime of the place
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)