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

# Salto KS

> Connect and configure Salto KS integration to automate granting and revoking door access for customers based on subscriptions and bookings, understand how the integration works and how users unlock doors, and troubleshoot common access issues

Integration with Salto KS access control solution allows you to automate granting customers temporary access to designated locks based on bookings and subscriptions.

Users can unlock doors directly from your Spacebring's member mobile app.

<Info>
  Salto KS is a distinct company not affiliated with Spacebring. For any inquiries regarding Salto KS's solutions, services, or pricing, please reach out to Salto KS directly. We do not have the authority to provide information or support on behalf of Salto KS.
</Info>

## Prerequisites

1. Set up your Salto KS account with all locks configured and added to access groups created exclusively for Spacebring.

<Danger>
  Reusing access groups created for other applications may cause errors.
</Danger>

2. Have access to the Salto KS administrator account.

## Connect Salto KS integration

1. Press the menu (...) next to the location's name > go to the **Integrations** page.

<Frame>
  <img src="https://mintcdn.com/spacebring/jk293S3HNXVg3OPE/images/integrations-access-control-salto-ks-1.png?fit=max&auto=format&n=jk293S3HNXVg3OPE&q=85&s=1ee5eba5539cf6fbd4a7ba12596d0288" alt="" width="1716" height="779" data-path="images/integrations-access-control-salto-ks-1.png" />
</Frame>

2. Find the **Salto KS** integration page and click `Connect`.
3. Give permission to connect Salto KS with Spacebring.
4. Select a "Site". You will see all Salto KS sites where you have an administrator role.
5. Set the digital key "Visibility". This controls which user roles can see the digital key option in your member mobile app.

<Frame>
  <img src="https://mintcdn.com/spacebring/jk293S3HNXVg3OPE/images/integrations-access-control-salto-ks-2.png?fit=max&auto=format&n=jk293S3HNXVg3OPE&q=85&s=deb9a30f2f827d088f4d74ce4a0880ff" alt="" width="2332" height="1167" data-path="images/integrations-access-control-salto-ks-2.png" />
</Frame>

<Info>
  You can connect a separate Salto KS account to each location in Spacebring.
</Info>

## Configure Salto KS integration

The integration allows granting access based on:

* Subscription
* Room booking
* Desk booking
* Office booking
* Equipment booking
* Parking booking

### Access based on subscriptions

**For future new members**

1. For membership plans, open the [plan settings](/billing/plans) > "Access" section > select the appropriate Salto KS access group.
2. For resource rentals, open the [resource settings](/resource-management/edit-a-resource) > "Access" section > select the appropriate Salto KS access group.
3. When you [create subscriptions](/billing/subscriptions) for customers or customers [sign up](/billing/plans/immediate-sign-ups) by themselves, the user is automatically synced to the selected Salto KS access group for the duration of their subscription.

##### **For existing members**

1. [Open member's subscription](/billing/subscriptions/edit-a-subscription) > open a specific item.
2. In the "Access" section, select the appropriate Salto KS access group.

Adding or editing access takes effect immediately. ​

<Frame>
  <img src="https://mintcdn.com/spacebring/jk293S3HNXVg3OPE/images/integrations-access-control-salto-ks-3.png?fit=max&auto=format&n=jk293S3HNXVg3OPE&q=85&s=1766bf1937e2535829ac89648e39e290" alt="" width="1526" height="1382" data-path="images/integrations-access-control-salto-ks-3.png" />
</Frame>

#### Access for resource bookings

To automate access for resource bookings:

1. Go to **Resources** > **Rooms, Desks, Offices, Parking**, or **Equipment** page.
2. Open the [resource settings](/resource-management/edit-a-resource) and select the appropriate Salto KS access group in the "Access" section.

<Frame>
  <img src="https://mintcdn.com/spacebring/jk293S3HNXVg3OPE/images/integrations-access-control-salto-ks-4.png?fit=max&auto=format&n=jk293S3HNXVg3OPE&q=85&s=0607b1e44185421a7c90e731129c3977" alt="" width="1446" height="1308" data-path="images/integrations-access-control-salto-ks-4.png" />
</Frame>

## How Salto KS integration works

### Access based on subscriptions

* When a user gets a subscription, they are synced to the assigned access group for the entire subscription period.
* Company subscriptions grant access to all users within the company.
* Customers are synced to the access group at midnight (00:00) on their subscription start date.
* When a subscription expires or is canceled, access is automatically revoked.

<Info>
  Access remains active from the subscription start date until its end or cancellation date, regardless of the customer's invoice payment status. To revoke access, [schedule a subscription end](/billing/subscriptions/edit-a-subscription), or [cancel it](/billing/subscriptions/cancel-a-subscription).
</Info>

#### Access based on bookings

* Users receive access to the assigned access group for the full duration of their booking.
* Invitees to room bookings also receive access.
* Users have a 30-minute grace period before and after the booking time:

| Booking time       | Access window      |
| ------------------ | ------------------ |
| 12:00 PM - 4:00 PM | 11:30 AM - 4:30 PM |
| 9:30 AM - 11:30 AM | 9:00 AM - 12:00 PM |

### How users unlock doors

**Existing users (already have Salto KS account)**

Users who have previously had at least one booking or subscription with Salto KS access will see the `Get digital key` button at the top of the main page in the member mobile app.

##### **New users (no prior access)**

Users without prior access will not see the `Get digital key` button. It will appear only when they get the first booking (30 minutes before the booking), or subscription (on the subscription start date).

##### **User journey**

1. Users tap **Get digital key** at the top of the main **Locations** page.
2. They see the **Activating digital key…** message. Spacebring redirects them to Salto KS and automatically authenticates them within a few seconds—no action required from users.
3. Once authentication is complete, the button changes to **Unlock**.

<Frame>
  <img src="https://mintcdn.com/spacebring/jk293S3HNXVg3OPE/images/integrations-access-control-salto-ks-5.png?fit=max&auto=format&n=jk293S3HNXVg3OPE&q=85&s=3be960eac26509bc780d959cdf68cd5b" alt="" width="1690" height="1062" data-path="images/integrations-access-control-salto-ks-5.png" />
</Frame>

4. When users want to open a door, they click **Unlock**.
   * During the first unlock, the app will request them to grant Bluetooth permission.
5. Then, the app prompts them: **Ready to unlock. Tap your phone on the lock reader.**
6. The user taps the phone on the lock reader and sees the message: **Signal sent. Try opening the door.**

<Frame>
  <img src="https://mintcdn.com/spacebring/jk293S3HNXVg3OPE/images/integrations-access-control-salto-ks-6.png?fit=max&auto=format&n=jk293S3HNXVg3OPE&q=85&s=681e576f4a90a0c7418d92ddc4d0c42a" alt="" width="1690" height="1062" data-path="images/integrations-access-control-salto-ks-6.png" />
</Frame>

* If a user is not eligible to unlock this door, the lock will indicate this with a sound or a red LED.

<Info>
  Users can use the digital key only in the member mobile app, not in the member web portal. If you don’t have the Member mobile apps add-on, you can still use the Salto KS integration with Spacebring to automate granting and revoking customer access. However, users will need to install the Salto KS app and use it to unlock doors.
</Info>

## Disconnect Salto KS

1. Press the menu (...) next to the location's name > go to the **Integrations** page > **Salto KS**.
2. Press `Disconnect` and confirm your choice.

<Danger>
  When the integration is disconnected, access will not be granted for future bookings or subscriptions. Any access already granted remains active and must be revoked manually through the Salto KS dashboard.
</Danger>

## Troubleshoot Salto KS access issues

Here are a few common errors you may encounter and how to resolve them:

<Accordion title="Lock compatibility">
  * Not all Salto KS locks support digital key unlocking. Test each of your locks individually.
  * If a lock does not support digital keys, contact Salto KS for assistance.
</Accordion>

<Accordion title="Low-power locks">
  * Some locks operate in low-energy (sleep) mode.
  * In these cases, simply holding the phone near the reader may not work—users should firmly tap their phone on the reader.
</Accordion>

<Accordion title="Apple Wallet behavior on iOS smartphones">
  * On iOS devices, tapping the phone on the lock may trigger Apple Wallet to open. This does not interfere with unlocking.
  * If you want to prevent this behavior, the owner of your Apple Developer account can contact Apple to request suppression of Apple Wallet for your app.
  * Apple may require additional information or agreements, so it's best for the account holder to handle this request directly.
</Accordion>

<Accordion title="&#x22;Enable Bluetooth and locaton permissions to unlock doors&#x22;">
  * During the first unlock using the digital key, the member portal or mobile app requests users to grant Bluetooth/Location permissions to unlock doors.
  * If they reject any of these permissions, while clicking the `Unlock` button, the user will see the "Enable Bluetooth and locaton permissions to unlock doors" error message.
  * To solve this, the user needs to navigate to their device settings > select your member mobile app and enable the required permissions for it.
</Accordion>

<Accordion title="&#x22;Could not grant access&#x22;">
  Administrators may see a "Could not grant access" error in their members' profiles. This error occurs when the user's data fails to synchronize to Salto KS, and the user, therefore, doesn't receive access based on their subscription. The issue can happen due to the temporary unresponsiveness of the API on the side of Salto KS while syncing data.

  To solve this issue:

  1. Navigate to Spacebring > **Customers** > select the necessary customer.
  2. Tap on the subscription in the "Subscription" section.
  3. Scroll down and locate the "Access" section > choose "Not selected" from the drop-down list > press `Save`.

  <Frame>
    <img src="https://mintcdn.com/spacebring/Cr6Ubsow5j3WT_8D/images/integrations-access-control-salto-ks-troubleshoot-salto-ks-access-1.png?fit=max&auto=format&n=Cr6Ubsow5j3WT_8D&q=85&s=a8b1851f7888f21b55b939d8c177f0b2" alt="" width="2368" height="1366" data-path="images/integrations-access-control-salto-ks-troubleshoot-salto-ks-access-1.png" />
  </Frame>

  4. Reopen the subscription > in the "Access" section, select the necessary Salto KS access group again > press `Save`.

  After completing these steps, Spacebring will attempt to sync the users to the Salto KS dashboard again to grant the required access.
</Accordion>

**FAQs**

<Accordion title="How do I manage access granting for company members who rotate coming to the space?">
  To ensure that only the members who are actually coming in get access, follow these steps:

  1. Do not assign an access group to the company's subscription. This prevents all company members from receiving access by default.
  2. Include the required number of day passes in the [company's subscription.](/billing/subscriptions) Company members need to [use these day passes to book a seat](/billing/credits-and-day-passes/day-passes) when they plan to come in.
  3. Assign an [access group in the desk settings](/integrations/access-control/salto-ks/salto-ks). This ensures that only those company members who have an active desk booking for the current day will be granted access.

  As a result, access will be automatically granted only to those who have booked a desk and are scheduled to come in that day—not the entire company.
</Accordion>

<Accordion title="How to set up access groups for different doors?">
  To ensure a seamless flow for your members, create multiple access groups in Salto KS based on your space layout and then link them to the specific resources or plans in Spacebring:

  * **Front door lock:** If you only have one main door, create a single access group and link it to all your resources and plans.
  * **Front door lock and Private offices locks:** To give office tenants private access, create separate access groups for each individual office. Each group should include the "Front door" lock plus that "Specific office" lock. Link each unique group to its corresponding office resource.
  * **Front door lock and locks for certain rooms:**
    * Create groups for each "Room" + "Front door". Link each room to the access groups you created for it so users only access the specific room they booked.
    * To provide access to desks, open spaces, or lounges, you only need one access group containing the "Front door" lock.
  * **Tiered access:** For members on different plans, create groups with the same locks but different time restrictions. Link these groups to the corresponding plans — for example, a "9 AM – 6 PM" group for regular members and a "24/7" group for those on exclusive plans.
</Accordion>
