# Create a new building

Create a new building record in the property module of the PMS. The request body should contain the necessary details for the building, such as name, address, facilities, and operational attributes. Upon successful creation, the response will include the newly created building's details.

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

## Query parameters:

  - `currentUser` (object, required)

## Request fields (application/json):

  - `buildingManagementType` (string, required)
    The type of building management MANAGED or AGENCY. MANAGED by the operator, AGENCY by a third party.
    Enum: "MANAGED", "AGENCY"

  - `networkOperator` (object)
    Company summary associated with the finance account

  - `networkOperator.id` (integer)
    Unique identifier of the company

  - `networkOperator.companyName` (string)
    Name of the company

  - `id` (integer)
    The unique identifier of the building

  - `development` (object)
    Summary of the development the building belongs to

  - `development.id` (integer)
    Unique identifier of the Development
    Example: 1

  - `development.name` (string)
    Name of the Development
    Example: "The Residences"

  - `buildingAddress` (object, required)
    Address details of the building

  - `buildingAddress.id` (integer)
    Unique identifier of the address

  - `buildingAddress.addressLine1` (string)
    First line of the address

  - `buildingAddress.addressLine2` (string)
    Second line of the address

  - `buildingAddress.addressLine3` (string)
    Third line of the address

  - `buildingAddress.city` (string)
    City of the address

  - `buildingAddress.postCode` (string)
    Postal code of the address

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

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

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

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

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

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

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

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

  - `shortName` (string)
    Short name of the building

  - `latitude` (number, required)
    Latitude coordinate of the building

  - `longitude` (number, required)
    Longitude coordinate of the building

  - `directions` (string)
    Directions to the building

  - `shortDescription` (string, required)
    Short description of the building

  - `longDescription` (string, required)
    Long description of the building

  - `minStay` (integer, required)
    Minimum stay duration in the building

  - `maxStay` (integer, required)
    Maximum stay duration in the building

  - `siteId` (string)
    Site identifier of the building for access control systems

  - `organisationSettings` (object, required)
    Organisation settings

  - `organisationSettings.id` (integer)
    The unique identifier of the organisation settings
    Example: 1

  - `organisationSettings.name` (string)
    The name of the organisation
    Example: "Resharmonics"

  - `organisationSettings.currency` (object)
    The currency of the organisation

  - `organisationSettings.currency.id` (integer)
    Unique identifier of the currency

  - `organisationSettings.currency.name` (string)
    Name of the currency

  - `organisationSettings.currency.description` (string)
    Description of the currency

  - `organisationSettings.currency.symbol` (string)
    Symbol of the currency

  - `organisationSettings.currency.exchangeRate` (number)
    Exchange rate of the currency

  - `organisationSettings.currency.baseRate` (number)
    Base rate of the currency

  - `organisationSettings.currency.unit` (string)
    Unit of the currency

  - `organisationSettings.currency.autoUpdate` (boolean)
    Indicates if the currency is auto-updated

  - `organisationSettings.currency.primaryCurrency` (boolean)
    Indicates if this is the primary currency

  - `organisationSettings.currency.htmlSafeSymbol` (string)
    HTML safe symbol of the currency

  - `shortDescriptionLang2` (string)
    Short description in second language

  - `shortDescriptionLang3` (string)
    Short description in third language

  - `shortDescriptionLang4` (string)
    Short description in fourth language

  - `shortDescriptionLang5` (string)
    Short description in fifth language

  - `longDescriptionLang2` (string)
    Long description in second language

  - `longDescriptionLang3` (string)
    Long description in third language

  - `longDescriptionLang4` (string)
    Long description in fourth language

  - `longDescriptionLang5` (string)
    Long description in fifth language

  - `directionsLang2` (string)
    Directions in second language

  - `directionsLang3` (string)
    Directions in third language

  - `directionsLang4` (string)
    Directions in fourth language

  - `directionsLang5` (string)
    Directions in fifth language

  - `saltoSpaceServiceId` (string)
    Salto space service identifier

  - `uuid` (string)
    UUID of the building

  - `thirdPartyUrl` (string)
    Third party URL associated with the building

  - `houseRules` (string)
    House rules of the building

  - `bookingType` (object)
    Booking type of the building

  - `bookingType.id` (integer)
    The unique identifier of the booking type

  - `bookingType.name` (string)
    The name of the booking type

  - `bookingType.description` (string)
    The description of the booking type

  - `bookingType.shortCode` (string)
    The short code of the booking type

  - `bookingType.billingType` (string)
    The billing type of the booking
    Enum: "ON_ACCOUNT", "CREDIT_CARD", "CASH_PAYMENT", "BANK_PAYMENT", "VIRTUAL_CARD"

  - `bookingType.emailTo` (string)
    The email recipient of the booking
    Enum: "BOOKING_CONTACT", "BOOKING_GUESTS", "BOOKING_CONTACT_AND_GUESTS"

  - `bookingType.systemBookingType` (boolean)
    Indicates if it is a system booking type

  - `bookingType.systemName` (string)
    The system name of the booking type

  - `bookingType.uuid` (string)
    The unique identifier for the booking type

## Response 201 fields (application/json):

  - `buildingManagementType` (string, required)
    The type of building management MANAGED or AGENCY. MANAGED by the operator, AGENCY by a third party.
    Enum: "MANAGED", "AGENCY"

  - `networkOperator` (object)
    Company summary associated with the finance account

  - `networkOperator.id` (integer)
    Unique identifier of the company

  - `networkOperator.companyName` (string)
    Name of the company

  - `id` (integer)
    The unique identifier of the building

  - `development` (object)
    Summary of the development the building belongs to

  - `development.id` (integer)
    Unique identifier of the Development
    Example: 1

  - `development.name` (string)
    Name of the Development
    Example: "The Residences"

  - `buildingAddress` (object, required)
    Address details of the building

  - `buildingAddress.id` (integer)
    Unique identifier of the address

  - `buildingAddress.addressLine1` (string)
    First line of the address

  - `buildingAddress.addressLine2` (string)
    Second line of the address

  - `buildingAddress.addressLine3` (string)
    Third line of the address

  - `buildingAddress.city` (string)
    City of the address

  - `buildingAddress.postCode` (string)
    Postal code of the address

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

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

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

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

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

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

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

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

  - `shortName` (string)
    Short name of the building

  - `latitude` (number, required)
    Latitude coordinate of the building

  - `longitude` (number, required)
    Longitude coordinate of the building

  - `directions` (string)
    Directions to the building

  - `shortDescription` (string, required)
    Short description of the building

  - `longDescription` (string, required)
    Long description of the building

  - `minStay` (integer, required)
    Minimum stay duration in the building

  - `maxStay` (integer, required)
    Maximum stay duration in the building

  - `siteId` (string)
    Site identifier of the building for access control systems

  - `organisationSettings` (object, required)
    Organisation settings

  - `organisationSettings.id` (integer)
    The unique identifier of the organisation settings
    Example: 1

  - `organisationSettings.name` (string)
    The name of the organisation
    Example: "Resharmonics"

  - `organisationSettings.currency` (object)
    The currency of the organisation

  - `organisationSettings.currency.id` (integer)
    Unique identifier of the currency

  - `organisationSettings.currency.name` (string)
    Name of the currency

  - `organisationSettings.currency.description` (string)
    Description of the currency

  - `organisationSettings.currency.symbol` (string)
    Symbol of the currency

  - `organisationSettings.currency.exchangeRate` (number)
    Exchange rate of the currency

  - `organisationSettings.currency.baseRate` (number)
    Base rate of the currency

  - `organisationSettings.currency.unit` (string)
    Unit of the currency

  - `organisationSettings.currency.autoUpdate` (boolean)
    Indicates if the currency is auto-updated

  - `organisationSettings.currency.primaryCurrency` (boolean)
    Indicates if this is the primary currency

  - `organisationSettings.currency.htmlSafeSymbol` (string)
    HTML safe symbol of the currency

  - `shortDescriptionLang2` (string)
    Short description in second language

  - `shortDescriptionLang3` (string)
    Short description in third language

  - `shortDescriptionLang4` (string)
    Short description in fourth language

  - `shortDescriptionLang5` (string)
    Short description in fifth language

  - `longDescriptionLang2` (string)
    Long description in second language

  - `longDescriptionLang3` (string)
    Long description in third language

  - `longDescriptionLang4` (string)
    Long description in fourth language

  - `longDescriptionLang5` (string)
    Long description in fifth language

  - `directionsLang2` (string)
    Directions in second language

  - `directionsLang3` (string)
    Directions in third language

  - `directionsLang4` (string)
    Directions in fourth language

  - `directionsLang5` (string)
    Directions in fifth language

  - `saltoSpaceServiceId` (string)
    Salto space service identifier

  - `uuid` (string)
    UUID of the building

  - `thirdPartyUrl` (string)
    Third party URL associated with the building

  - `houseRules` (string)
    House rules of the building

  - `bookingType` (object)
    Booking type of the building

  - `bookingType.id` (integer)
    The unique identifier of the booking type

  - `bookingType.name` (string)
    The name of the booking type

  - `bookingType.description` (string)
    The description of the booking type

  - `bookingType.shortCode` (string)
    The short code of the booking type

  - `bookingType.billingType` (string)
    The billing type of the booking
    Enum: "ON_ACCOUNT", "CREDIT_CARD", "CASH_PAYMENT", "BANK_PAYMENT", "VIRTUAL_CARD"

  - `bookingType.emailTo` (string)
    The email recipient of the booking
    Enum: "BOOKING_CONTACT", "BOOKING_GUESTS", "BOOKING_CONTACT_AND_GUESTS"

  - `bookingType.systemBookingType` (boolean)
    Indicates if it is a system booking type

  - `bookingType.systemName` (string)
    The system name of the booking type

  - `bookingType.uuid` (string)
    The unique identifier for the booking type