> ## 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.

# Tapkey

> Connect and configure Tapkey to automate door access for customers based on subscriptions and bookings, understand how the integration works and how users unlock doors, and fix access errors

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

> [!NOTE]
>
> Tapkey is a distinct company not affiliated with us. For any inquiries regarding Tapkey's solutions, services, or pricing, please reach out to Tapkey directly. We do not have the authority to provide information or support on behalf of Tapkey.

## Prerequisites

1. Set up your Tapkey account.
   * Enable and add user groups exclusively for Spacebring.
   * Configure all locks and add to user groups.

> [!WARNING]
>
> Reusing access groups created for other applications may cause errors.

2. Have access to the Tapkey administrator account.

## Connect Tapkey integration

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

![Location menu open in the left panel with Integrations highlighted on Spacebring's coworking space management platform](https://mintcdn.com/spacebring/EoXqL0krIeX5lJ8K/images/integrations-connect-a-location-level-integration.png?fit=max\&auto=format\&n=EoXqL0krIeX5lJ8K\&q=85\&s=59910549be2afb079049dadf53f7e2b9)

2. Find the **Tapkey** integration page and click **Connect**.

![](https://mintcdn.com/spacebring/NXOhFSPltwhOqCNG/images/integrations-access-control-tapkey-2.png?fit=max\&auto=format\&n=NXOhFSPltwhOqCNG\&q=85\&s=fcc3b5655849ab2c23db4a1040f9e57b)

3. Give permission to connect Tapkey with Spacebring.
4. Select a locking system.

> [!NOTE]
>
> You can connect a separate Tapkey account to each location in Spacebring.

## Configure access for Tapkey

The integration allows granting access based on:

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

### Access for subscriptions

#### For future new members

1. For memberships, open the [membership settings](https://www.spacebring.com/docs/catalog/memberships.md) > **Access** section > select the appropriate Tapkey user group.
2. For resource rentals, open the [resource settings](https://www.spacebring.com/docs/resource-management/edit-a-resource.md) > **Integrations** tab > **Access** section > select the appropriate Tapkey user group.
3. When you [create subscriptions](https://www.spacebring.com/docs/billing/subscriptions.md) for customers or customers [sign up](https://www.spacebring.com/docs/catalog/memberships/immediate-sign-ups.md) by themselves, the user is automatically synced to the selected Tapkey user group for the duration of their subscription.

##### For existing members

1. [Open member's subscription](https://www.spacebring.com/docs/billing/subscriptions/edit.md) > open a specific item.
2. In the **Access** section, select the appropriate Tapkey user group.

Adding or editing access takes effect immediately.

![](https://mintcdn.com/spacebring/NXOhFSPltwhOqCNG/images/integrations-access-control-tapkey-3.png?fit=max\&auto=format\&n=NXOhFSPltwhOqCNG\&q=85\&s=2145a26811418a6163f42513f199c558)

#### Access for resource bookings

To automate access for customers for resource bookings:

1. Go to **Resources** > **Rooms, Desks, Offices, Parking**, or **Equipment** page.
2. Open the [resource settings](https://www.spacebring.com/docs/resource-management/edit-a-resource.md) > **Integrations** tab and select the appropriate Tapkey user group in the **Access** section.

![](https://mintcdn.com/spacebring/NXOhFSPltwhOqCNG/images/integrations-access-control-tapkey-4.png?fit=max\&auto=format\&n=NXOhFSPltwhOqCNG\&q=85\&s=ae1cab604943a3c72f4b42f4c4723a50)

#### Access for memberships with day passes

Customers subscribed to a membership with day passes come to the space only on the days they book a desk, so tie their access to the booking rather than to the subscription.

1. In the [membership settings](https://www.spacebring.com/docs/catalog/memberships.md) > **Access** section, keep **Not selected**.
2. Open the hot desk [resource settings](https://www.spacebring.com/docs/resource-management/edit-a-resource.md) > **Integrations** tab > **Access** section > select the appropriate Tapkey user group.

Members [book a hot desk with a day pass](https://www.spacebring.com/docs/billing/credits-and-day-passes/day-passes.md) on the days they come in and receive access for the duration of their booking, plus a 30-minute grace period before and after it.

> [!WARNING]
>
> Selecting a user group in the membership would grant members access for the whole subscription period, including the days they don't come in.

## How Tapkey 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, regardless of how many memberships or seats the subscription includes, including employees added to the company later.
* 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.

> [!NOTE]
>
> 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](https://www.spacebring.com/docs/billing/subscriptions/edit.md), or [cancel it](https://www.spacebring.com/docs/billing/subscriptions/cancel.md).

#### 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

1. When a user makes a booking or purchases a subscription, they are automatically synced to your Tapkey dashboard.
2. The user needs to install the Tapkey app and set up their account.
   * They must use the same email address as in your member web portal or mobile app
3. Once set up, users unlock doors through the Tapkey app.

> [!NOTE]
>
> To unlock a door, users must be physically present in front of the corresponding lock.

#### Inform customers how to unlock doors

Users do not receive automated emails from Tapkey about access. Guide your customers how to unlock doors:

* Add custom [booking confirmation emails](https://www.spacebring.com/docs/general/customize-emails.md) in resource settings (e.g., for nonmembers). Explain to them that upon arrival, they can unlock doors via the Tapkey app, signed in with the same email address they use in your member web portal or mobile app.
* [Create a **How to enter the space** guide.](https://www.spacebring.com/docs/support/guides.md) This way, all customers will be able to find instructions on unlocking doors on your **Information** and **Support** pages at any time.

## Disconnect Tapkey

To disconnect Tapkey, follow these steps:

1. Go to Spacebring > **Integrations** page by pressing the menu **(...)** next to the location's name > **Tapkey**.
2. Press **Disconnect** and confirm your choice.

> [!WARNING]
>
> 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 Tapkey dashboard.

## Troubleshoot Tapkey access errors

When Spacebring can't grant a customer access, administrators get a [notification](https://www.spacebring.com/docs/account/notifications.md) that ends with the error in quotes.

> [accordion] "The Tapkey plan has no smartphone users left. Add smartphone users to the plan in Tapkey or remove contacts who no longer need access."
>
> **What it means:** Your Tapkey plan includes a limited number of smartphone users, and all of them are in use. Spacebring can't add more customers to Tapkey, so they can't unlock doors. Spacebring doesn't try again on its own.
>
> **How to fix it:**
>
> 1. In Tapkey, add smartphone users to your plan, or remove contacts who no longer need access.
> 2. For each customer who didn't get access through a subscription, open their [subscription](https://www.spacebring.com/docs/billing/subscriptions/edit.md) item, set **Access** to **Not selected**, and save.
> 3. Open the item again, select the Tapkey user group in **Access**, and save.

## FAQs

> [accordion] How to set up access groups for different doors?
>
> To ensure a seamless flow for your members, create multiple access groups in Tapkey based on your space layout and then link them to the specific resources or memberships 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 memberships.
> * **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 with different memberships, create groups with the same locks but different time restrictions. Link these groups to the corresponding memberships — for example, a "9 AM – 6 PM" group for regular members and a "24/7" group for those with exclusive memberships.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.