# Create a new region

Creates a new region within the Property Management System (PMS) with the provided details. Regions 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 region. If the creation is successful, the newly created region's details will be returned. In case of an unexpected system error, a  will be triggered.

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

## Request fields (application/json):

  - `id` (integer)
    Unique identifier of the region

  - `name` (string, required)
    Name of the region

  - `country` (object, required)
    Data Transfer Object representing a Country entity in the Property Management System (PMS).

  - `country.id` (integer)
    Unique identifier of the country

  - `country.name` (string, required)
    Name of the country

  - `country.sortOrder` (integer, required)
    Sort order of the country

  - `country.countryCodeAlpha2` (string, required)
    Alpha-2 country code

  - `country.countryCodeAlpha3` (string, required)
    Alpha-3 country code

  - `country.countryCodeNumeric` (string, required)
    Numeric country code

## Response 201 fields (application/json):

  - `id` (integer)
    Unique identifier of the region

  - `name` (string, required)
    Name of the region

  - `country` (object, required)
    Data Transfer Object representing a Country entity in the Property Management System (PMS).

  - `country.id` (integer)
    Unique identifier of the country

  - `country.name` (string, required)
    Name of the country

  - `country.sortOrder` (integer, required)
    Sort order of the country

  - `country.countryCodeAlpha2` (string, required)
    Alpha-2 country code

  - `country.countryCodeAlpha3` (string, required)
    Alpha-3 country code

  - `country.countryCodeNumeric` (string, required)
    Numeric country code