# Create a new city

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

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

## Request fields (application/json):

  - `id` (integer)
    City ID
    Example: 1

  - `name` (string)
    City name
    Example: "Birmingham"

  - `region` (object)
    Region details

  - `region.id` (integer)
    Region ID
    Example: 1

  - `region.name` (string)
    Region name
    Example: "West Midlands"

## Response 201 fields (application/json):

  - `id` (integer)
    City ID
    Example: 1

  - `name` (string)
    City name
    Example: "Birmingham"

  - `region` (object)
    Region details

  - `region.id` (integer)
    Region ID
    Example: 1

  - `region.name` (string)
    Region name
    Example: "West Midlands"