How to Connect a Tedee Smart Lock

All help ressources
>
How to Connect a Tedee Smart Lock

What is the Tedee integration?

The Tedee integration lets you connect your Tedee smart lock to Nowistay so that unique PIN codes are automatically generated for every guest booking. No more coordinating key handoffs, hiding lockboxes, or manually programming access codes. Nowistay creates, updates, and removes the guest code for you.

Each guest receives a temporary code that only works during their stay, from check-in to check-out. If a booking changes, the code validity window is updated. If a booking is cancelled or moved back to pending, the code is revoked.

Important: only one smart lock can be assigned per property. If you use multiple lock brands, such as Tedee, Nuki, igloohome, or TTLock, you need to choose one smart lock provider per property.

Prerequisites

Before connecting Tedee to Nowistay, make sure you have:

  • A Tedee smart lock installed and visible in your Tedee account.
  • A Tedee keypad paired with the lock, because guests need a keypad to unlock with a PIN code.
  • A Tedee bridge or online remote connection for the lock. Nowistay manages PINs remotely, so the lock must be reachable from the Tedee cloud.
  • A Tedee account with owner or administrator access to the lock you want to connect.
  • Your properties must be configured with Nowistay PMS. Only properties using the Nowistay PMS integration appear in the lock configuration panel. Properties connected via direct OTA integration or a third-party PMS, such as Beds24, Lodgify, or Smoobu, are not displayed. If you are currently using another PMS, see how to migrate to Nowistay PMS.
  • An active AI Assistant subscription for the property.

If the keypad is not paired, or if the lock cannot be reached remotely, Nowistay will not be able to create, update, or delete PIN codes reliably.

Step 1: Prepare your Tedee lock

Open the Tedee app and check that the lock you want to use is installed, paired with its keypad, and visible in your account. If you manage several locks, give each lock a clear name, such as the property name or unit number. This makes the assignment step much easier inside Nowistay.

You can also create a manual test PIN in Tedee first to confirm that the keypad works correctly. Once the integration is connected, Nowistay will create the guest PINs automatically.

Step 2: Connect Tedee to Nowistay

Go to Integrations from your Nowistay dashboard. Under the Smart locks section, find the Tedee card and click Connect.

[Screenshot needed: Nowistay Integrations page showing the Tedee card under Smart locks]

Tedee uses a secure OAuth connection. This means you do not need to copy a client ID, secret, API key, or password into Nowistay. Instead, Nowistay redirects you to Tedee, where you sign in and approve the connection.

  1. Click Connect Tedee in the Tedee drawer.
  2. Sign in with the Tedee account that owns or administers your locks.
  3. Approve the requested permissions.
  4. You are redirected back to Nowistay.

[Screenshot needed: Tedee OAuth authorization screen and Nowistay Tedee drawer after connection]

If the authorization succeeds, your Tedee account name appears as connected. If you cancel the authorization, close the Tedee page, or use an account that does not have access to the lock, simply restart the connection from the Tedee drawer.

Step 3: Assign locks to your properties

Once connected, the drawer shows the Lock assignments section with the list of eligible properties.

For each property you want to equip with Tedee access:

  1. Find the property in the list. Use the filter field if you manage many properties.
  2. Click the dropdown next to the property name.
  3. Choose the Tedee lock that belongs to that property.
  4. Adjust the code generation timing, access margin, and code source if needed.

Important: each property can only have one active smart lock assignment at a time, regardless of the brand. If the property already has a Nuki, igloohome, or TTLock lock assigned, remove it first before assigning a Tedee lock.

To change the assigned lock later, select a different lock from the dropdown. To remove an assignment, click Remove.

[Screenshot needed: Tedee drawer showing lock assignments, code timing, access margin, and code source settings]

How automatic PIN codes work

Once a Tedee lock is assigned to a property, Nowistay handles the code lifecycle automatically:

  1. A confirmed booking is created for your property from Airbnb, Booking.com, direct booking, or another connected source.
  2. Before the guest arrives, Nowistay generates a unique PIN code. By default, the code is generated 5 days before check-in, but you can configure this per lock from 1 to 14 days.
  3. The code is active only during the stay. It starts before the scheduled check-in time and stops after the scheduled check-out time, based on the access margin you configured.
  4. If the booking dates or negotiated times change, Nowistay updates the PIN validity window on the Tedee lock.
  5. If the booking is cancelled or set back to pending, Nowistay removes the PIN from the lock.
  6. After checkout, expired codes are cleaned up automatically.

Configuring the code generation timing

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 Generate codes X days before arrival.

You can set any value between 1 and 14 days. The default is 5 days.

Examples:

  • A guest checks in on March 20 and the setting is 5 days: the code is generated on March 15.
  • A guest checks in on March 20 and the setting is 1 day: the code is generated on March 19.

If the code cannot be generated on the scheduled day, for example because the lock, keypad, or bridge 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 timezone.

Configuring the access margin

The access margin controls how much extra time the code is valid before check-in and after check-out. This setting appears below the generation timing, labeled Access margin.

You can set any value between 0 and 240 minutes, which is 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:

  • Check-in at 3:00 PM, check-out at 11:00 AM, margin 30 min: code works from 2:30 PM to 11:30 AM.
  • Check-in at 3:00 PM, check-out at 11:00 AM, margin 120 min: code works from 1:00 PM to 1:00 PM the next day.
  • Check-in at 4:00 PM, check-out at 10:00 AM, margin 0 min: code works from 4:00 PM to 10:00 AM exactly.

What about check-in and check-out times?

The code validity window is based on the check-in and check-out times set for the booking. Nowistay uses the property timezone and checks:

  • The negotiated check-in or check-out times if they are set on the booking, for example after approving early check-in or late checkout.
  • Otherwise, the default check-in and check-out times configured on the property.
  • If neither is set, Nowistay defaults to 3:00 PM check-in and 11:00 AM check-out.

Negotiated times are capped to reasonable limits so a guest code cannot be extended too far outside the planned stay.

What if code generation fails?

If Nowistay cannot generate a Tedee PIN, the system keeps retrying every hour:

  • The evening before check-in, around 6:00 PM local time: if the code still has not been generated, you receive an email alert so you can investigate.
  • Midnight on the check-in day, local time: the system stops retrying.

Using the code in automated messages

The generated PIN 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 a check-in message that includes:

Your door code is {{smartlock_code}}. It will be active from check-in to check-out. Enter the code on the Tedee keypad to unlock the door.

This way, your guests receive their access code automatically without you needing to copy it from Tedee.

Choosing a code source

By default, Nowistay generates a random 6-digit PIN for each booking. You can also choose to use the last 6 digits of the guest phone number, which can make the code easier for guests to remember.

To change this setting, open the Tedee settings for the property and look for the Code source dropdown. You have two options:

  • Random code, default: Nowistay generates a unique random code for every booking.
  • Last 6 digits of guest phone: Nowistay derives the code from the guest phone number when possible.

Tedee PINs must follow Tedee rules: they must be numeric, contain 5 to 8 digits, include at least 3 different digits, and cannot be a simple ascending or descending sequence such as 123456 or 654321. Nowistay uses 6-digit codes. If the guest phone number is missing, too short, already used, or rejected by Tedee rules, Nowistay automatically falls back to a random code.

Disconnecting Tedee

If you need to disconnect your Tedee account, open the Tedee panel from Integrations and click Disconnect next to your connected account name.

Disconnecting will:

  • Remove all Tedee lock assignments from your properties.
  • Stop generating PIN codes for future bookings.

Active codes for current guests remain valid until they expire naturally or are removed by the normal booking lifecycle.

Troubleshooting

I do not see my Tedee lock in Nowistay

Check that the lock is visible in the Tedee account you connected, that your account has owner or administrator access, and that the lock is online. Also make sure the keypad is paired and the lock can be managed remotely.

I do not see a property in the lock assignment list

Only properties using Nowistay PMS and an active AI Assistant subscription appear in the smart lock assignment list. If a property is connected through a direct OTA integration or another PMS connector, it will not appear.

The code was not created

Make sure the booking is confirmed, the lock assignment is active, and the code generation date has arrived. If Tedee is temporarily unreachable, Nowistay retries automatically and sends an email alert if the issue continues until the evening before check-in.

The OAuth connection failed

Restart the connection from the Tedee drawer and sign in with the Tedee account that owns or administers the lock. If your browser blocks popups or redirects, allow the Tedee sign-in page and try again.

Ready to Put Your Rental on Autopilot?

Join 300+ property managers who save hours every week with AI-powered guest communication.