Tuya smart locks

By connecting Tuya smart locks to Meety, you can send customers a unique access code right after they book. The code works only during the appointment window (with a configurable time buffer before and after). It’s ideal for coworking spaces, escape rooms, saunas, room rentals, or businesses without a permanent reception desk.

You can assign one lock to multiple services, and assign multiple locks to one service — for example, a main entrance and a separate room.

What Meety does automatically

After a service booking is created, Meety:

1. generates a temporary PIN in Tuya valid from the start of the appointment (minus buffer) until the end (plus buffer),
2. shows the code to the customer on the booking confirmation page,
3. sends the code in emails (booking confirmation and reminders).

The default buffer is 5 minutes before and after the appointment. You can change it per lock (0–1440 minutes).

If the code cannot be generated (lock offline, Tuya cloud error, or another reason), Meety:

• retries generation approximately every 15 minutes while the appointment is still valid,
• shows the customer a backup code if you configured one for the lock,
• notifies you by email if generation fails (make sure the business owner’s email in Meety is up to date).

Change the backup code regularly — it’s for emergency access when the appointment-specific PIN isn’t available. Customers cannot tell whether they’re seeing a unique or backup code.

What you need to connect locks to Meety

Before setting up in Meety, you need:

1. A lock in the Tuya app (Tuya Smart or Smart Life) — the device must be paired and online, and you must be able to control it from the app
2. Ownership of the “Home” in the Tuya app where the lock is added.
3. A cloud project on the Tuya IoT Platform with smart lock API credentials and your device linked to that project.

Official Tuya documentation:

• Create a cloud project
• Add a device to the project
• Lock password / PIN management (API)

Need help with setup?

Connecting Tuya locks involves steps in the mobile app and on the Tuya IoT Platform. If anything is unclear, you don’t want to set up the cloud project yourself, or you’d like a step-by-step walkthrough, email us — we’re happy to help. If you already use Meety, you can also reach us via the Support button in the app navigation.

Step 1: Set up in the Tuya app

1. Install Tuya Smart or Smart Life and sign in.
2. Create or open the Home where the lock will live.
3. Add the smart lock following the manufacturer’s instructions (Bluetooth / Wi‑Fi).
4. Confirm you are the home owner — otherwise you won’t be able to authorize the device in the cloud project.
5. In the lock details, note the Device ID — in Meety you’ll enter it in the Device ID field.

Step 2: Cloud project on the Tuya IoT Platform

1. Sign in or create an account at platform.tuya.com (Tuya Developer Platform).
2. In the menu, go to Cloud → Development and click Create Cloud Project.
3. Fill in the project name, choose Custom as the development method, and pick the Data Center for your region (for Europe this usually matches the openapi.tuyaeu.com host that Meety uses).
4. On Authorize API Services, enable smart lock / door lock and password management (temporary password) services. Without these APIs, Meety cannot create a PIN.
5. After the project is created, copy from the project details:
   • Access ID (also called Client ID in Tuya docs) → Meety Access ID field,
   • Access Secret (Client Secret) → Meety Access Secret field.
6. Link the lock to the project (important) — in the project settings, add the device from your home to this cloud project (“Link App Account” / “Add Device” depending on the current Tuya UI). Scan the QR code with your mobile Tuya app after choosing “Add App Account > Tuya App Account Authorization”. After this, your lock should appear in the project — otherwise API calls will fail.

If you’re unsure about API permissions, search Tuya’s docs for “Smart Lock” or “Door Lock Password” and confirm they’re assigned to your project.

Step 3: Add the lock in Meety

1. In your business admin, open Settings.
2. Choose Smart locks.
3. Click Add new lock.
4. Fill in:
   • Lock name — e.g. “Entrance” or “Sauna” (shown when managing services),
   • Access ID and Access Secret from the cloud project,
   • Device ID from the Tuya app or platform,
   • Backup code — a static PIN the customer gets if the temporary code isn’t generated,
   • Time buffer — how many minutes before and after the appointment the code stays valid.
5. Click Save.

Repeat for each physical lock (one device = one entry in Meety).

Step 4: Assign locks to a service

1. Open Services and edit the service that should grant automatic access (e.g. room rental).
2. Go to the Resources tab.
3. In Smart locks, select one or more locks to generate a code for each booking.
4. Save the service.

Locks from the customer’s perspective

After a successful booking, the customer sees Your room access code on the confirmation page and in emails. The text explains that the code is valid from a set time before the appointment until after it ends.

Each booking gets its own PIN for every assigned lock.

Tips and troubleshooting

Problem	What to check
Code not generated	Access ID / Secret, device ID, whether the lock is in the cloud project and online in the Tuya app
Customer didn’t receive a code	Service linked to a lock; booking not cancelled; backup code set on the lock
Code doesn’t work on the lock	Buffer (arriving too early); business time zone; whether the PIN works manually in the Tuya app
Error after changing password in Tuya	Update the backup code in Meety

Security: Treat Access Secret in Meety like a password — don’t share it, and if compromised, rotate it on the Tuya platform and update it in Meety.

Related tutorials: Managing services, Managing appointments, SMS notifications.