# Create a new area

Creates a new area within the Property Management System (PMS) with the provided details. Areas help in organizing properties, defining operational zones, and generating location-based insights. This endpoint is useful for adding new areas to the system for better management and reporting. The request body should contain the necessary details for the new area. If the creation is successful, the newly created area's details will be returned. In case of an unexpected system error, a  will be triggered.

Endpoint: POST /api/v3/areas
Version: 3.0.4
Security: OAuth2

## Request fields (application/json):

  - `id` (integer)
    ID of the area

  - `name` (string)
    Name of the area

  - `city` (object)
    City which the area is part of

  - `city.id` (integer)
    ID of the city

  - `city.name` (string)
    Name of the city

## Response 201 fields (application/json):

  - `id` (integer)
    ID of the area

  - `name` (string)
    Name of the area

  - `city` (object)
    City which the area is part of

  - `city.id` (integer)
    ID of the city

  - `city.name` (string)
    Name of the city