Skip to main content
You can create mobile credentials that enable your mobile app users to unlock entrances in your Salto Space access system. For each Salto Space user, you can create a maximum of one key card credential and one mobile key credential. For more information about Seam mobile keys, see Mobile Access. To use the Seam API to create mobile credentials for mobile app users in a Salto Space access system:
  1. Create a user identity. Seam user identities enable you to match your own mobile app users to access system users that you create using the Seam API.
  2. Create an access system user on the Salto Space access system or assign an existing access system user to the user identity.
    The resources that you create for the access system user are available under the associated user identity.
  3. Assign the access system user to one or more access groups.
    • Each access group is preconfigured with the allowed entrances.
  4. Create a credential to represent the mobile key.
The following example walks you through this process: Code: 
// Get the access system.
const buildingA = await seam.acs.systems.get({
  acs_system_id: '11111111-1111-1111-1111-111111111111',
})

// Step 1:
// Create a user identity that corresponds to your user's app account.
const janeUser = await seam.userIdentities.create({
  full_name: 'Jane Doe',
})

// Step 2:
// Create an access system user on the Salto Space access system.
const accessSystemUser = await seam.acs.users.create({
  user_identity_id: janeUser.user_identity_id,
  acs_system_id: buildingA.acs_system_id,
  full_name: janeUser.full_name,
  phone_number: '+15555550100',
})

// Step 3:
// Add the access system user to all desired access groups.
const accessGroupIds = [
  '44444444-4444-4444-4444-333333333333',
  '44444444-4444-4444-4444-444444444444',
]
for (const accessGroupId of accessGroupIds) {
  await seam.acs.users.addToAccessGroup({
    acs_user_id: accessSystemUser.acs_user_id,
    acs_access_group_id: accessGroupId,
  })
}

// Step 4:
// Create a mobile key for the access system user.
const mobileKey = await seam.acs.credentials.create({
  acs_user_id: accessSystemUser.acs_user_id,
  access_method: 'mobile_key',
  is_multi_phone_sync_credential: true,
})
Output: 
{
  acs_credential_id: '66666666-6666-6666-6666-666666666666',
  acs_user_id: '33333333-3333-3333-3333-333333333333',
  access_method: 'mobile_key',
  ...
}

​
Learn More

To find out more about using the Seam API with your Salto Space access system, see the following topics: