# Create a new Access Group

Create a new unit access group within the Property Management System (PMS). This endpoint allows the creation of a new unit access group, which links a unit to an access group. The request body must include details of the unit and the access group. The response includes the newly created unit access group details. In case of validation errors, a  error will be returned. In case of an unexpected system error, a  will be triggered.

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

## Query parameters:

  - `currentUser` (object, required)

## Request fields (application/json):

  - `id` (integer)
    Unique identifier of the Unit Access Group

  - `unit` (object, required)
    Summary of the Unit associated with the Unit Access Group

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

  - `unit.name` (string)
    Name of the unit
    Example: "Apartment 101"

  - `accessGroup` (object, required)
    Access Group DTO

  - `accessGroup.id` (integer)
    Id of Access Group

  - `accessGroup.name` (string, required)
    Name of Access Group

  - `accessGroup.building` (object, required)
    Building associated with the unit type

  - `accessGroup.building.id` (integer)
    Unique identifier of the building

  - `accessGroup.building.name` (string)
    Name of the building

  - `accessGroup.externalIdentifier` (string, required)
    External Identifier of Access Group

## Response 200 fields (application/json):

  - `id` (integer)
    Unique identifier of the Unit Access Group

  - `unit` (object, required)
    Summary of the Unit associated with the Unit Access Group

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

  - `unit.name` (string)
    Name of the unit
    Example: "Apartment 101"

  - `accessGroup` (object, required)
    Access Group DTO

  - `accessGroup.id` (integer)
    Id of Access Group

  - `accessGroup.name` (string, required)
    Name of Access Group

  - `accessGroup.building` (object, required)
    Building associated with the unit type

  - `accessGroup.building.id` (integer)
    Unique identifier of the building

  - `accessGroup.building.name` (string)
    Name of the building

  - `accessGroup.externalIdentifier` (string, required)
    External Identifier of Access Group