Connecting Your Smart Lock
KeySherpa uses Seam to communicate with your smart lock. Seam is a universal smart device API that supports 150+ lock brands. This guide walks you through the full setup from hardware to your first automated tour.
Before you start
- A compatible smart lock installed on your property door
- The lock's hub or bridge connected to your WiFi (if required)
- The lock manufacturer's app installed and the lock added to your account
- Your KeySherpa account with at least one property created
Setup Steps
Create a Seam account
Seam is the service that bridges KeySherpa and your physical lock. You need a free Seam account to get started.
- 1Go to console.seam.co and sign up for a free account
- 2Create a new workspace — name it after your company
- 3From the left menu, go to API Keys and create a new key. Copy it — you'll need it shortly.
Connect your lock to Seam
In Seam, you'll connect your lock by logging into your lock manufacturer's account (Schlage, SmartThings, August, etc.).
- 1In the Seam Console, click Devices → Connect a Device
- 2Select your lock brand from the list (e.g. SmartThings, Schlage, August)
- 3Log in with your lock manufacturer account credentials
- 4Your lock should appear in Devices within a few seconds. Confirm it shows as Online.
SmartThings users: Make sure your lock is first added to the SmartThings app and your hub is online before connecting to Seam.
Add your Seam API key to KeySherpa
This is what allows KeySherpa to automatically create and delete PIN codes on your lock.
- 1In KeySherpa, go to Settings and find the Seam API Key field
- 2Paste your Seam API key (starts with
seam_) and save - 3Go to Integrations — your lock should now appear in the Connected Devices list
Assign the lock to a property
Each property in KeySherpa needs to be linked to a specific lock device.
- 1Go to Properties and open the property you want to enable tours for
- 2Click Edit and find the Smart Lock Device dropdown
- 3Select your lock from the list and save
You're live — test it
Book a test tour through your tour page. KeySherpa will automatically generate a PIN code 15 minutes before the tour starts and delete it when the tour ends. The visitor receives the code by SMS and on the tour access page.
Pro tip: Check Integrations in your dashboard to monitor lock status, battery level, and connectivity in real time.
Compatible Lock Brands
Schlage
Encode, Connect, Sense
SmartThings
Any Z-Wave lock connected to SmartThings Hub
August
Smart Lock Pro, WiFi Smart Lock
Yale
Assure Lock, Access, Conexis
Kwikset
Halo, SmartCode 888, 914
Igloohome
Smart Deadbolt, Smart Padlock
Full list of 150+ supported devices at docs.seam.co
Troubleshooting
My lock shows as Offline in the dashboard
Check that your lock hub is powered on and connected to WiFi. For SmartThings, open the app and confirm the hub status is Active. Locks go offline if the hub loses internet.
PIN codes aren't being created
Confirm your Seam API key is saved in Settings and your property has a lock assigned. Also check that the tour status transitions correctly — codes are programmed 15 minutes before the tour starts via Inngest automation.
The lock shows online but the keypad isn't accepting codes
Try locking and unlocking from the Seam console to verify communication. If the keypad hardware itself isn't responding, it may need a factory reset or the keypad ribbon cable may be loose — contact the lock manufacturer.
I connected my lock to Seam but it doesn't appear in KeySherpa
Go to Integrations and refresh the page. If it still doesn't appear, verify your Seam API key in Settings is the correct one from your Seam workspace.