Manage Roles in Alexa Smart Properties


An Alexa Smart Properties user's role defines the operations that the user is allowed to perform on units. A user must have an assigned role before they can access any Alexa Smart Properties resources. The creator of a unit is assigned the administrator role for that unit automatically.

Alexa Smart Properties defines the following roles: organization administrator (A4H.OrgAdmin) and unit administrator (A4P.UnitAdmin).

The organization administrator role has access to administer the organizational unit and all capabilities allowed to the customer (for example, solution integrator). An organization can have more than one organization administrator.

The unit administrator role has access to and manages an individual unit.

Organization administrator (A4H.OrgAdmin)

The Alexa Smart Properties organizational unit (A4H.Org) represents an Alexa Smart Properties organization under an Alexa organization. An A4H.OrgAdmin user role is created automatically when the organizational unit is created.

The organization administrator role owns the Amazon Business account. An organization can have one or more organization administrators.

The organization administrator role has permission to perform the following operations:

  • Create, list, update, and delete units that they created or for which they have the A4P.UnitAdmin role.
  • Create, delete, get, assign, and remove roles and list assigned roles for the organization.
  • Call all Alexa Smart Properties APIs.

Unit administrator (A4P.UnitAdmin)

The Alexa Smart Properties in senior living unit (Unit) represents a property, group of rooms, or room under an Alexa Smart Properties in senior living organizational unit. The A4P.UnitAdmin user role is created asynchronously within several seconds after the unit is created.

The unit administrator role has permission to perform the following operations on units for which they have the A4P.UnitAdmin role:

  • Get, list, update, and delete units.
  • Call all Alexa Smart Properties APIs.

Legacy roles

This content refers to roles in a previous version of Alexa for Hospitality in DE, FR, IT, UK, and UK.

Property administrator (A4H.PropertyAdmin)

The Alexa Smart Properties for hospitality property unit (Property) represents a property under an Alexa Smart Properties for hospitality organizational unit. The A4H.PropertyAdmin user role is created automatically when the property is created.

The property administrator role has permission to perform the following operations on properties for which they have the A4H.PropertyAdmin role:

  • Get, list, update, and delete properties.
  • Create and list room types.
  • Call all APIs.

Room type administrator (A4H.RoomTypeAdmin)

The Alexa Smart Properties for hospitality room type unit (RoomType) represents a room type under an Alexa Smart Properties for hospitality property. The A4H.RoomTypeAdmin user role is created automatically when the room type is created.

The room type administrator role has permission to perform the following operations:

  • Create, get, list, update, and delete room types.
  • Create and list rooms that they have access to.
  • Call all APIs for created room types and room types for which they have the A4H.RoomTypeAdmin role.
  • Create, delete, get, assign, and remove roles and list assigned roles for created room types.

Room administrator (A4H.RoomAdmin)

The Alexa Smart Properties for hospitality room unit (Room) represents a room under an Alexa Smart Properties for hospitality room type. The A4H.RoomAdmin user role is created automatically when the room is created.

The room administrator role has permission to perform the following operations:

  • Create, get, list, update, and delete rooms.
  • Call all APIs for created rooms and rooms for which they have the A4H.RoomAdmin role.
  • Create, delete, get, assign, and remove roles and list assigned roles for created rooms.

Was this page helpful?

Last updated: Nov 28, 2023