Smart Locks That Support Remote Lock

Your user links their lock or access system account through Seam Connect Webview. Seam returns the doors behind it as devices and entrances. Confirm can_remotely_lock is true on what comes back. False means the lock is capable but cannot use it right now, and a missing property means it never does this.

Send a POST to /locks/lock_door with the device_id. The response is an action attempt: pending means it is still in progress, and error includes the failure reason. For success, also check result.was_confirmed_by_device because some providers cannot confirm the action on the physical lock.

1// Set SEAM_API_KEY on your server.
2import { Seam } from "seam"
3
4const seam = new Seam()
5
6// Replace with a connected lock's device_id.
7const device = await seam.devices.get({ device_id: "6ba7b811-9dad-11d1-80b4-00c04fd430c8" })
8if (device.can_remotely_lock !== true) {
9  throw new Error("This lock cannot remotely lock right now")
10}
11const action = await seam.locks.lockDoor({ device_id: device.device_id })
12console.log(action) // Check status and result.was_confirmed_by_device.

Check action_attempt.result.was_confirmed_by_device: some providers report success without physical-device confirmation. Read properties.locked for the reported lock state, or subscribe to lock.locked events. A locked state does not prove the door is closed. Use a separate door-position sensor if your workflow needs that confirmation.

1// Set SEAM_API_KEY on your server.
2import { Seam } from "seam"
3
4const seam = new Seam()
5
6// Read after the action attempt completes. Expected locked: true; this does not report door position.
7const device = await seam.devices.get({ device_id: "6ba7b811-9dad-11d1-80b4-00c04fd430c8" })
8console.log(device.properties.locked)