> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seam.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing ACS Users

> Learn how to manage your ACS users to grant or revoke physical access for people.

<Info>
  **Granting access?** [Access Grants](/use-cases/granting-access/index) are the
  default and recommended way to grant access—they manage the underlying codes
  and credentials for you, across standalone smart locks and access systems
  alike.
</Info>

An ACS user typically refers to an individual who requires access, like an employee or resident. Each user can possess multiple credentials that serve as their keys or identifiers for access. The type of credential can vary widely. For example, in the [Salto](/device-and-system-integration-guides/salto-locks) system, a user can have a PIN code, a mobile app account, and a fob. In other platforms, it is not uncommon for a user to have more than one of the same credential type, such as multiple key cards. Additionally, these credentials can have a schedule or validity period.

This guide explains how to create and manage ACS users. Using the [Access Control Systems API](/api/acs/object), you can automate issuing access to long-term tenants or visitors.

***

## Before You Begin: Identify the ACS System ID

To add ACS users to your access control system, first retrieve the `acs_system_id` of the ACS that you want to configure. To retrieve the ACS details, use [Get a System](/api/acs/systems/get) or [List Systems](/api/acs/systems/list). Then, continue to the remaining sections in this topic to learn how to manage ACS users.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.acs.systems.list()
  ```

  ```bash cURL theme={null}
  # Use GET or POST.
  curl -X 'GET' \
    'https://connect.getseam.com/acs/systems/list' \
    -H 'accept: application/json' \
    -H "Authorization: Bearer ${API_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{}'
  ```

  ```python Python theme={null}
  seam.acs.systems.list()
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->acs->systems->list();
  ```

  ```csharp C# theme={null}
  seam.SystemsAcs.List();
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  [
    {
      acs_system_id: '11111111-1111-1111-1111-111111111111',
      name: 'Visionline System',
      ...
    },
    ...
  ]
  ```

  ```json cURL theme={null}
  {
    "acs_systems": [
      {
        "acs_system_id": "11111111-1111-1111-1111-111111111111",
        "name": "Visionline System",
        ...
      },
      ...
    ],
    "ok": true
  }
  ```

  ```json Python theme={null}
  [
    AcsSystem(
      acs_system_id='11111111-1111-1111-1111-111111111111',
      name='Visionline System',
      ...
    ),
    ...
  ]
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  [
    {
      "acs_system_id": "11111111-1111-1111-1111-111111111111",
      "name": "Visionline System",
      ...
    },
    ...
  ]
  ```

  ```json C# theme={null}
  {
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "name": "Visionline System",
    ...
  }
  ...
  ```
</CodeGroup>

***

## Create an ACS User

To [create an ACS user](/api/acs/users/create), provide the `acs_system_id` of the ACS system and the attributes of the user, such as the `full_name`, `email_address`, `phone_number`, and so on.

Also, if your [ACS architecture](../../low-level-apis/access-systems/connect-an-acs-to-seam/understanding-access-control-system-differences) supports access groups, you can also assign an ACS user to one or more access groups. To do so, when you create the user, include the IDs of the access group to which you want add the user. The `acs_access_group_ids` parameter accepts an array of strings.

In addition, if your ACS architecture supports assigning access schedules directly to ACS users, you can specify an `access_schedule` for the user, including a `starts_at` and `ends_at` date and time.

Further, you can use the `user_identity_id` parameter to associate a new ACS user with a [user identity](/api/user_identities/object). You can use a user identity to link an ACS user with an app user in your system, such as a [mobile access app user](../../capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) or an app user who needs access to multiple ACSs.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await 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',
  })
  ```

  ```bash cURL theme={null}
  curl -X 'POST' \
    'https://connect.getseam.com/acs/users/create' \
    -H 'accept: application/json' \
    -H "Authorization: Bearer ${API_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{
    "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"
  }'
  ```

  ```python Python theme={null}
  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"
  )
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $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"
  );
  ```

  ```csharp C# theme={null}
  seam.UsersAcs.Create(
    acsSystemId: "11111111-1111-1111-1111-111111111111",
    userIdentityId: "22222222-2222-2222-2222-222222222222",
    fullName: "Jane Doe",
    emailAddress: "jane@example.com",
    phoneNumber: "+15555550101"
  );
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  {
    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',
    ...
  }
  ```

  ```json cURL theme={null}
  {
    "acs_user": {
      "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",
      ...
    },
    "ok": true
  }
  ```

  ```json Python theme={null}
  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',
    ...
  )
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  {
    "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",
    ...
  }
  ```

  ```json C# theme={null}
  {
    "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",
    ...
  }
  ```
</CodeGroup>

***

## List ACS Users

To [list all ACS users](/api/acs/users/list) within an `acs_system`, provide the `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:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.acs.users.list({
    acs_system_id: '11111111-1111-1111-1111-111111111111',
  })
  ```

  ```bash cURL theme={null}
  # Use GET or POST.
  curl -X 'GET' \
    'https://connect.getseam.com/acs/users/list' \
    -H 'accept: application/json' \
    -H "Authorization: Bearer ${API_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{
    "acs_system_id": "11111111-1111-1111-1111-111111111111"
  }'
  ```

  ```python Python theme={null}
  seam.acs.users.list(
    acs_system_id="11111111-1111-1111-1111-111111111111"
  )
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->acs->users->list(
    acs_system_id: "11111111-1111-1111-1111-111111111111"
  );
  ```

  ```csharp C# theme={null}
  seam.UsersAcs.List(
    acsSystemId: "11111111-1111-1111-1111-111111111111"
  );
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  [
    {
      acs_user_id: '33333333-3333-3333-3333-333333333333',
      full_name: 'Jane Doe',
      email_address: 'jane@example.com',
      ...
    },
    ...
  ]
  ```

  ```json cURL theme={null}
  {
    "acs_users": [
      {
        "acs_user_id": "33333333-3333-3333-3333-333333333333",
        "full_name": "Jane Doe",
        "email_address": "jane@example.com",
        ...
      },
      ...
    ],
    "ok": true
  }
  ```

  ```json Python theme={null}
  [
    AcsUser(
      acs_user_id='33333333-3333-3333-3333-333333333333',
      full_name='Jane Doe',
      email_address='jane@example.com',
      ...
    ),
    ...
  ]
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  [
    {
      "acs_user_id": "33333333-3333-3333-3333-333333333333",
      "full_name": "Jane Doe",
      "email_address": "jane@example.com",
      ...
    },
    ...
  ]
  ```

  ```json C# theme={null}
  {
    "acs_user_id": "33333333-3333-3333-3333-333333333333",
    "full_name": "Jane Doe",
    "email_address": "jane@example.com",
    ...
  }
  ...
  ```
</CodeGroup>

***

## Get an ACS User

To [get an ACS user](/api/acs/users/get), provide the `acs_user_id` of the user that you want to retrieve. These details include the contact details for the user, the user's access schedule, the associated [user identity](/api/user_identities/object), if applicable, and so on.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.acs.users.get({
    acs_user_id: '33333333-3333-3333-3333-333333333333',
  })
  ```

  ```bash cURL theme={null}
  # Use GET or POST.
  curl -X 'GET' \
    'https://connect.getseam.com/acs/users/get' \
    -H 'accept: application/json' \
    -H "Authorization: Bearer ${API_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{
    "acs_user_id": "33333333-3333-3333-3333-333333333333"
  }'
  ```

  ```python Python theme={null}
  seam.acs.users.get(
   acs_user_id="33333333-3333-3333-3333-333333333333"
  )
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->acs->users->get(
    acs_user_id: "33333333-3333-3333-3333-333333333333"
  );
  ```

  ```csharp C# theme={null}
  seam.AcsUsers.Get(
    acsUserId: "33333333-3333-3333-3333-333333333333"
  );
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  {
    acs_user_id: '33333333-3333-3333-3333-333333333333',
    full_name: 'Jane Doe',
    email_address: 'jane@example.com',
    phone_number: '+15555550100',
    acs_system_id: '11111111-1111-1111-1111-111111111111',
    access_schedule: {
      "starts_at": "2024-03-01T10:40:00.000Z",
      "ends_at": "2024-03-04T10:40:00.000Z"
    },
    user_identity_id: '22222222-2222-2222-2222-222222222222',
    ...
  }
  ```

  ```json cURL theme={null}
  {
    "acs_user": {
      "acs_user_id": "33333333-3333-3333-3333-333333333333",
      "full_name": "Jane Doe",
      "email_address": "jane@example.com",
      "phone_number": "+15555550100",
      "acs_system_id": "11111111-1111-1111-1111-111111111111",
      "access_schedule": {
        "starts_at": "2024-03-01T10:40:00.000Z",
        "ends_at": "2024-03-04T10:40:00.000Z"
      },
      "user_identity_id": "22222222-2222-2222-2222-222222222222",
      ...
    },
    "ok": true
  }
  ```

  ```json Python theme={null}
  AcsUser(
    acs_user_id='33333333-3333-3333-3333-333333333333',
    full_name='Jane Doe',
    email_address='jane@example.com',
    phone_number='+15555550100',
    acs_system_id='11111111-1111-1111-1111-111111111111',
    access_schedule={
      'starts_at': '2024-03-01T10:40:00.000Z',
      'ends_at': '2024-03-04T10:40:00.000Z'
    },
    user_identity_id='22222222-2222-2222-2222-222222222222',
    ...
  )
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  {
    "acs_user_id": "33333333-3333-3333-3333-333333333333",
    "full_name": "Jane Doe",
    "email_address": "jane@example.com",
    "phone_number": "+15555550100",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "access_schedule": {
      "starts_at": "2024-03-01T10:40:00.000Z",
      "ends_at": "2024-03-04T10:40:00.000Z"
    },
    "user_identity_id": "22222222-2222-2222-2222-222222222222",
    ...
  }
  ```

  ```json C# theme={null}
  {
    "acs_user_id": "33333333-3333-3333-3333-333333333333",
    "full_name": "Jane Doe",
    "email_address": "jane@example.com",
    "phone_number": "+15555550100",
    "acs_system_id": "11111111-1111-1111-1111-111111111111",
    "access_schedule": {
      "starts_at": "2024-03-01T10:40:00.000Z",
      "ends_at": "2024-03-04T10:40:00.000Z"
    },
    "user_identity_id": "22222222-2222-2222-2222-222222222222",
    ..
  }
  ```
</CodeGroup>

***

## Update an ACS User

To [update an ACS user](/api/acs/users/update), provide the `acs_user_id` of the user that you want to update, along with the attributes that you want to modify, such as the contact details for the user or the user's access schedule.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.acs.users.update({
    acs_user_id: '33333333-3333-3333-3333-333333333333',
    full_name: 'Jack Doe',
  })
  ```

  ```bash cURL theme={null}
  curl -X 'POST' \
    "https://connect.getseam.com/acs/users/update" \
    -H 'accept: application/json' \
    -H "Authorization: Bearer ${API_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{
    "acs_user_id": "33333333-3333-3333-3333-333333333333",
    "full_name": "Jack Doe"
  }'
  ```

  ```python Python theme={null}
  seam.acs.users.update(
    acs_user_id="33333333-3333-3333-3333-333333333333",
    full_name="Jack Doe"
  )
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->acs->users->update(
    acs_user_id: "33333333-3333-3333-3333-333333333333",
    full_name: "Jack Doe"
  );
  ```

  ```csharp C# theme={null}
  seam.UsersAcs.Update(
    acsUserId: "33333333-3333-3333-3333-333333333333",
    fullName: "Jack Doe"
  );
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  void
  ```

  ```json cURL theme={null}
  {
    "ok": true
  }
  ```

  ```json Python theme={null}
  None
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  void
  ```

  ```json C# theme={null}
  void
  ```
</CodeGroup>

***

## Delete an ACS User

To [delete an ACS user](/api/acs/users/delete), provide the `acs_user_id` of the user that you want to delete.

**Request:**

<CodeGroup>
  ```javascript JavaScript theme={null}
  await seam.acs.users.delete({
    acs_user_id: '33333333-3333-3333-3333-333333333333',
  })
  ```

  ```bash cURL theme={null}
  curl -X 'POST' \
    'https://connect.getseam.com/acs/users/delete' \
    -H 'accept: application/json' \
    -H "Authorization: Bearer ${API_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{
    "acs_user_id": "33333333-3333-3333-3333-333333333333"
  }'
  ```

  ```python Python theme={null}
  seam.acs.users.delete(
    acs_user_id="33333333-3333-3333-3333-333333333333"
  )
  ```

  ```ruby Ruby theme={null}
  # Coming soon!
  ```

  ```php PHP theme={null}
  $seam->acs->users->delete(
    acs_user_id: "33333333-3333-3333-3333-333333333333"
  );
  ```

  ```csharp C# theme={null}
  seam.UsersAcs.Delete(
    acsUserId: "33333333-3333-3333-3333-333333333333"
  );
  ```
</CodeGroup>

**Response:**

<CodeGroup>
  ```json JavaScript theme={null}
  void
  ```

  ```json cURL theme={null}
  {
    "ok": true
  }
  ```

  ```json Python theme={null}
  None
  ```

  ```json Ruby theme={null}
  # Coming soon!
  ```

  ```json PHP theme={null}
  void
  ```

  ```json C# theme={null}
  void
  ```
</CodeGroup>