How to Connect the TTLock Smart Lock Integration

What is the TTLock integration?

The TTLock integration lets you connect your TTLock smart lock to Nowistay so that unique passcodes 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.

Important: only one smart lock can be assigned per property. If you use multiple lock brands (TTLock, Nuki, igloohome), you need to choose one per property.

Prerequisites

Before connecting TTLock to Nowistay, make sure you have:

• A TTLock smart lock with V4 keypad password support — Nowistay can only manage passcodes on locks that support the V4 keypad password standard.
• A TTLock gateway connected to your lock — the gateway provides the internet connection that allows Nowistay to create and manage codes remotely. Without a gateway, codes cannot be sent to the lock.
• A TTLock account — you'll need your TTLock username and password to connect.

If your lock isn't connected to a gateway, or doesn't support V4 keypad passwords, the integration won't work.

Step 1: Connect TTLock to Nowistay

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

The TTLock connection panel will open. Enter your TTLock username and TTLock password, then click "Connect TTLock".

If the credentials are valid, you'll see a success message and your TTLock account name will appear as connected.

Step 2: Assign locks to your properties

Once connected, the panel shows the "Lock assignments" section with a list of your properties.

For each property you want to equip with smart access:

1. Find the property in the list (use the "Filter properties..." search bar).
2. Click the dropdown next to the property name.
3. Choose the TTLock lock you want to assign to that property.

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

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

How automatic passcodes work

Once a lock is assigned to a property, Nowistay takes care of everything automatically:

1. A booking is created for your property (from any platform — Airbnb, Booking.com, direct booking, etc.).
2. Before the guest arrives, Nowistay generates a unique passcode. 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 during the guest's stay only — it starts working before the scheduled check-in time and stops working after the scheduled check-out time, based on the access margin you configured (default: 30 minutes, maximum: 240 minutes).
4. After checkout, the code is automatically revoked and deleted from the lock.

Configuring the code generation timing

For each lock, you can choose how many days before check-in Nowistay should generate and send the code. 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, if the lock or gateway 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).

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

• 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 (2 hours) → 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 each booking. Nowistay uses the property's timezone. It checks:

• The negotiated check-in/check-out times if set on the specific booking.
• Otherwise, the default check-in/check-out times configured on the property.
• If neither is set, it defaults to 3:00 PM check-in and 11:00 AM check-out.

What if code generation fails?

If Nowistay can't generate a code (for example, if the lock or gateway is offline), the system keeps retrying every hour:

• The evening before check-in (6:00 PM local time): if the code still hasn't 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 passcode 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 message triggered before check-in that includes:

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

Disconnecting TTLock

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

Disconnecting will:

• Remove all lock assignments from your properties.
• Stop generating passcodes for future guests.

Active codes for current guests will remain until they expire naturally at checkout.

Need help?

If you run into any issues setting up your TTLock integration, don't hesitate to contact us. We're here to help you get everything running smoothly.