> For the complete documentation index, see [llms.txt](https://docs.guestway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.guestway.io/integrations/smart-locks/how-to-connect-keycafe.md).

# How to connect Keycafe

This guide shows you how to connect Keycafe to Guestway with your Keycafe email and password, so you can manage key codes in Guestway.

{% hint style="info" %}
**Before you start**

* You have the **Super admin** role, or a role with access to integrations.
* Keycafe is in early access. It shows in the list, with the **Early Access** badge, only when Guestway has turned it on for your organization.
* You have the email and password of a Keycafe user without two-factor authentication, and the exact name of your Keycafe organization.
* Keycafe is a key exchange service: guests collect and drop off keys at Keycafe SmartBox locations with a code.
  {% endhint %}

## Connect the account

{% stepper %}
{% step %}

### Open the integrations

Go to **Settings** → **Organization** → **Integrations** and click **Create**.
{% endstep %}

{% step %}

### Choose Keycafe

Under **Smart Locks**, click **Keycafe**. In **Integration name**, keep the suggested name or enter your own.
{% endstep %}

{% step %}

### Enter your Keycafe organization

Enter the name of your Keycafe organization in **Organization Name**, exactly as in Keycafe. You cannot change it later.
{% endstep %}

{% step %}

### Sign in with Keycafe

Click **Login with Username & Password**. Enter your Keycafe email in **Email** and your password in **Password**, and click **Authenticate**. Then click **Finish**.

Guestway uses the password only to connect, and does not store it.
{% endstep %}
{% endstepper %}

## Link the keys

{% stepper %}
{% step %}

### Choose the keys to use

Each Keycafe key comes into Guestway as a smart lock. Open the integration and its smart lock tab, and tick **Subscribed** for each key you want to manage in Guestway. See [How to choose which listings and devices sync](https://docs.guestway.io/integrations/integrations/how-to-choose-which-listings-and-devices-sync.md).
{% endstep %}

{% step %}

### Link each key to its listing

In [Smart locks](https://docs.guestway.io/reservations-and-operations/smart-locks.md), open the key and link it to its listing or complex.
{% endstep %}
{% endstepper %}

## Troubleshooting

<details>

<summary>What if Keycafe asks for an SMS code?</summary>

When the Keycafe user has two-factor authentication on, Keycafe texts a code, and Guestway has no field to enter it yet. Connect with a Keycafe user without two-factor authentication, or contact <support@guestway.io>.

</details>

<details>

<summary>Why does the connection fail?</summary>

The name in **Organization Name** must match exactly one Keycafe organization. Check the spelling, and connect again.

</details>

<details>

<summary>Why can I not enter my own PIN code?</summary>

Keycafe makes the code. When you create an access code, Guestway shows *Keycafe generates a pin code for you.*

</details>

<details>

<summary>Why can I not disable a code?</summary>

Keycafe codes have no on and off state. To end access early, change the end of the code, or delete the code.

</details>

<details>

<summary>Why is there no Open Door button?</summary>

Keycafe is a key exchange, not a lock on the door. Guestway cannot open it remotely.

</details>

## Related

* [Smart locks](https://docs.guestway.io/reservations-and-operations/smart-locks.md): lock details and access codes
* [How to create an access code](https://docs.guestway.io/reservations-and-operations/smart-locks/how-to-create-an-access-code.md)
* [Integrations](https://docs.guestway.io/integrations/integrations.md): every field and action


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.guestway.io/integrations/smart-locks/how-to-connect-keycafe.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
