Get 1 month free with the code BETA !
The Nuki integration lets you connect your Nuki smart lock to Nowistay so that unique keypad codes are automatically generated for every guest booking. No more coordinating key handoffs, hiding lockboxes, or manually programming door codes — Nowistay handles everything for you.
Each guest receives a temporary code that only works during their stay (from check-in to check-out), and it's automatically revoked once they leave. If a guest unlocks the door with their code, Nowistay even detects the check-in automatically.
Important: only one smart lock can be assigned per property. If you use multiple lock brands (Nuki, igloohome, TTLock), you need to choose one per property.
Before connecting your Nuki lock in Nowistay, you'll need to complete a few setup steps on the Nuki side. Don't worry — we'll walk you through each one.
Note: The smart lock integration only works with properties configured with Nowistay PMS (channel manager). Properties connected via direct OTA integration or a third-party PMS (Beds24, Lodgify, Smoobu) will not appear in the lock configuration panel. If you're currently using another PMS, see how to migrate to Nowistay PMS.
If you haven't already, install your Nuki Smart Lock on your door and set it up using the Nuki App (available on iOS and Android).
Your lock needs to be connected to the internet. You can do this in two ways:
Once connected, open the Nuki App and go to your lock's Settings → Connection status. You should see the device shown as connected to the server.
Nuki Web is the online platform that allows your lock to be controlled remotely — which is what Nowistay uses to create and manage keypad codes.
To connect your lock to Nuki Web:
If you don't have a Nuki Web account yet, you can create one during this process. Once activated, you can log in to Nuki Web at web.nuki.io.
Now that your lock is connected to Nuki Web, you need to activate the API so that Nowistay can communicate with your lock.
Now that your Nuki account is ready, head over to Nowistay. Go to Integrations from your Nowistay dashboard.
You'll see the Nuki Smart Lock card under the Smart locks section. Click "Configure" to open the connection panel.
This is the simplest method. Here's how to generate your token:
Then, back in Nowistay:
If the token is valid, you'll see a success message and your Nuki account name will appear as connected.
Once connected, the panel will show the "Lock assignments" section with a list of your properties.
For each property that you want to equip with smart access:
You'll see a confirmation message: "Smart lock assigned to property".
Important: each property can only have one smart lock assigned at a time, regardless of the brand. If the property already has an igloohome or TTLock lock assigned, you'll need to remove it first before assigning a Nuki lock.
If you need to change the assigned lock later, simply select a different one from the dropdown. To remove a lock assignment entirely, click the "Remove" button that appears next to the assigned lock.
Nowistay does not require a Smart Hosting subscription on your Nuki account to use the integration with the API token method described above. This is a Nuki subscription plan designed specifically for short-term rental hosts — it enables features like creating temporary keypad codes for guests.
You can find the Smart Hosting plan in the "Short-Term Rental" section of your Nuki Web account, or visit the Nuki website for more details.
Once a lock is assigned to a property, Nowistay takes care of everything automatically. Here's what happens behind the scenes:
For each lock, you can choose how many days before check-in Nowistay should generate and send the code to the lock. This setting appears below the lock selector, labeled "Send code X days before check-in".
You can set any value between 1 and 14 days. The default is 5 days.
Examples:
If the code cannot be generated on the scheduled day (for example, if the lock is temporarily offline), Nowistay will automatically retry every hour until the code is successfully created — up to midnight on the check-in day (in the property's local timezone).
The access margin controls how much extra time the code is valid before check-in and after check-out. This setting appears below the code generation timing, labeled "Access margin".
You can set any value between 0 and 240 minutes (4 hours). The default is 30 minutes.
The margin is applied symmetrically: the same duration is added before check-in and after check-out.
Examples:
The code validity window is based on the check-in and check-out times set for each booking. Nowistay uses the property's timezone to determine the exact validity window. It checks:
When a guest uses their keypad code to unlock the door, Nowistay detects it and automatically records the check-in time. No manual confirmation needed.
If Nowistay can't generate a code (for example, if the lock is offline or unreachable), the system keeps retrying every hour. Here's what happens:
The generated keypad code is automatically available in your automated guest messages through the {{smartlock_code}} variable (the legacy {{nuki_code}} variable also works for backward compatibility).
For example, you can create an automated email triggered before check-in that includes something like:
"Your door code is {{smartlock_code}}. It will be active from check-in to check-out. Simply enter the code on the keypad to unlock the door."
This way, your guests receive their access code automatically — no manual work required.
If you ever need to disconnect your Nuki account, open the Nuki panel from Integrations and click the "Disconnect" link next to your account name.
A confirmation dialog will appear explaining that disconnecting will:
Active codes for current guests will remain until they expire naturally at checkout.
By default, Nowistay generates a random 6-digit code for each booking. But you can also choose to use the last 6 digits of your guest's phone number instead — making it much easier for them to remember their access code.
To change this setting, open the Nuki settings for your property and look for the Code source dropdown. You have two options:
If the guest phone mode is selected but the phone number is missing, too short, already in use, or rejected by the provider, Nowistay automatically falls back to a random code — so your guests always get a working access code.
Nuki keypads have specific restrictions: codes cannot contain the digit 0 and cannot start with 12. When using the guest phone mode, Nowistay handles this automatically — any 0 in the phone-based code is replaced with 1, and if the result starts with 12, the prefix is adjusted to 11. This way, your guests get a code that is as close to their phone number as possible while remaining compatible with the Nuki keypad.
If you run into any issues setting up your Nuki integration, don't hesitate to contact us. We're here to help you get everything running smoothly.
