Managing Users

Learn how to manage your users and sync tenants and visitors from your property management platform.

This guide explains how to create and manage users in an access control system (ACS). Using the Access Control Systems API, you can automate issuing access to long-term tenants or visitors.


Before You Begin

To add users to your access system, first retrieve the ID (acs_system_id) of the access system that you want to configure. To retrieve the access system details, use Get a System or List Systems. Then, continue to the remaining sections in this topic to learn how to manage users.

Request:

seam.acs.systems.list()

Response:

[
  AcsSystem(
    acs_system_id='11111111-1111-1111-1111-111111111111',
    name='Visionline System',
    ...
  ),
  ...
]

Create a User

To create a user, provide the ACS system ID (acs_system_id) of the system and the attributes of the user, such as the full name (full_name), email address (email_address), phone number (phone_number), and so on.

You can also assign a user to one or more access groups by including the access group IDs for the user as an array of strings in the acs_access_group_ids parameter. Further, you can use the user_identity_id parameter to associate a new user with a mobile access user identity, if desired. You can also specify an access_schedule for the user, including a starts_at and ends_at date and time.

Request:

seam.acs.users.create(
  acs_system_id="11111111-1111-1111-1111-111111111111",
  user_identity_id="22222222-2222-2222-2222-222222222222",
  full_name="Jane Doe",
  email_address="jane@example.com",
  phone_number="+15555550101"
)

Response:

AcsUser(
  acs_user_id='33333333-3333-3333-3333-333333333333',
  full_name='Jane Doe',
  email_address='jane@example.com',
  phone_number='+15555550101',
  acs_system_id='11111111-1111-1111-1111-111111111111',
  ...
)

Update a User

To update a user, provide the ID (acs_user_id) of the desired user, along with the attributes that you want to modify.

Request:

seam.acs.users.update(
  acs_user_id="33333333-3333-3333-3333-333333333333",
  full_name="Jack Doe"
)

Response:

None

Delete a User

To delete a user, provide the ID (acs_user_id) of the user that you want to delete.

Request:

seam.acs.users.delete(
  acs_user_id="33333333-3333-3333-3333-333333333333"
)

Response:

None

List Users

To list all users within an ACS, provide the ID (acs_system_id) of the ACS. You can also filter users by user_identity_id, user_identity_email_address, or user_identity_phone_number.

Request:

seam.acs.users.list(
  acs_system_id="11111111-1111-1111-1111-111111111111"
)

Response:

[
  AcsUser(
    acs_user_id='33333333-3333-3333-3333-333333333333',
    full_name='Jane Doe',
    email_address='jane@example.com',
    ...
  ),
  ...
]

Last updated

Logo

Š Seam Labs, Inc. All rights reserved.