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

# Humly

> Connect Humly room displays so your customers can see live resource availability and start bookings from the display.

## Overview

**Humly** room displays show whether a resource is currently available and guide your customers to the next free resource in your space. Each display links to a resource in your Nexudus account and updates as new bookings and check-ins are recorded.

The integration is set up in the Humly dashboard rather than in Nexudus — you connect your Nexudus account to Humly, then pair each physical display with a resource.

## What you need

* A **Humly account** — if you don't have one yet, find a reseller near you on [humly.com](https://www.humly.com).
* **One or several Humly room displays**. The first two steps of the integration can be completed before the displays arrive; you only need the hardware for the final step.
* **Two full unrestricted administrator users with API access**, dedicated to the Humly integration. One is used to connect Humly to Nexudus, the other to log in to your Humly account.

> [!NOTE]
>
> Dedicating administrator users to integrations keeps the connection stable. If you use your own account, any password reset or change to your user rights disconnects Nexudus from Humly and you have to run the integration again.

## Integrating Humly

The integration has three steps: connecting your Nexudus account to Humly, setting up your room displays, and connecting the displays to Nexudus resources.

### Step 1. Connect your Nexudus account to Humly

**1. Start from your cloud link**

Open the cloud link you've received from Humly in your browser, select **Nexudus** from the dropdown list, and click **Next**.

**2. Enter your administrator details**

Add the email address and password of the administrator user created for the Humly integration in the **Nexudus Server Admin Account and Password** fields, and the email address of the administrator user that will send and receive notifications in the **Nexudus Coworker Service Account** field. Click **Next** twice.

**3. Create your pairing key**

Define a pairing key and click **Next**. Save the pairing key somewhere safe — you'll need it in step 3 and every time you connect a new room display.

**4. Finish and log in**

Read the Terms of Service and click **Accept**, copy your password, and click **Finish**. Log in to your Humly account with that email address and password — you'll land in the Humly dashboard, where you finish the default setup for your displays.

### Step 2. Set up your Humly room displays

**1. Define defaults**

In the Humly dashboard, click **Next** and define the default settings for your room displays.

**2. Build your structure**

Add your space's country, city, building name, and the floor where your resources are, and click **Add**.

**3. Import your Nexudus resources**

Click **Import** and select the Nexudus resources you want to link to room displays. Drag and drop them into the structure you created and click **Finish**.

You're redirected to the **Rooms** section of the Humly dashboard, where you can control each individual display. The **Status** column shows grey circles until each display is connected to its resource in step 3.

### Step 3. Connect displays to Nexudus resources

Once your displays are installed near their resources (following Humly's mounting instructions), enable device registration and pair each display.

**Enable device registration:** open your Humly cloud link, log in, go to **Settings**, scroll to **Device Registration**, select a duration, and click **Start Registration**. The countdown starts immediately — extend it with **Restart** if you need more time.

**Pair a display:**

**1. Power on the display**

Turn on the display and tap **Continue**, then **Cloud Mode**.

**2. Enter your customer number**

Enter your Humly customer number and tap **Connect**. You'll find it at the beginning of your cloud link URL.

**3. Enter the pairing key**

Enter the pairing key you saved in step 1 and tap **Connect**.

**4. Choose your space and resource**

Select your space, then the resource this display sits on. The display is now connected and shows ongoing and upcoming bookings.

## Using the displays

Once integrated, your customers can use the displays straight away to see whether a resource is available. They can also start a booking in Nexudus directly from the display, either by holding their phone close to the display or by scanning its QR code.

If they have the [Passport app](https://learn.nexudus.com/passport/overview.md) (or its white-label equivalent) on their phone, the app opens automatically when they hold their phone near the display or scan the QR code, and they confirm and start their booking from there. The display updates automatically to show the next scheduled booking and changes color when the room becomes unavailable.

## FAQ

**Can my customers book a resource using our Humly room displays?**

Yes. The display acts as a launcher for bookings in Nexudus: holding a phone near the display or scanning its QR code opens the [Passport app](https://learn.nexudus.com/passport/overview.md) (or its white-label equivalent), where the customer confirms and starts the booking. The booking is recorded in Nexudus, and the display updates to reflect it. The display itself doesn't take a separate booking that stays only in Humly.

**How quickly are new Nexudus bookings shown on Humly room displays?**

Displays refresh every 60 seconds, so new bookings appear in near real time.

**Why do I need two dedicated administrator users?**

Dedicating administrator users to your integrations ensures the connection between Nexudus and Humly is maintained. If you used your own account, any password reset or edit to your user rights would automatically disconnect the two platforms and require you to reconnect them.

## Related

* [Sensors](https://learn.nexudus.com/integrations/sensors.md) — occupancy and presence data from room sensors
* [Space dashboard](https://learn.nexudus.com/integrations/workplace/space-dashboard.md) — displaying live space information


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