Lock Pro

May 16, 2026 ยท View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Smart Lock Pro
enableCloudServiceBooleandetermines if Cloud Service is enabled or not for the current device
hubDeviceIdStringdevice's parent Hub ID
groupBooleandetermines if a Lock is grouped with another Lock or not
masterBooleandetermines if a Lock is the master device or not when grouped with another Lock in Dual Lock mode
groupNameStringthe name of the Lock group
lockDevicesIdsArraya list of Lock device IDs such that the Lock devices are being grouped in Dual Lock mode

Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceTypeStringdevice type. Smart Lock Pro
hubDeviceIdStringdevice's parent Hub ID
batteryIntegerthe current battery level, 0-100
versionStringthe current firmware version, e.g. V4.2
lockStateStringdetermines if locked or not, jammed, unlock or lock
doorStateStringdetermines if the door is closed or not, open or close
calibrateBooleandetermines if Lock has been calibrated or not

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Lock Procommandlockdefaultrotate to locked position
Lock Procommandunlockdefaultrotate to unlocked position
Lock Procommanddeadboltdefaultdisengage deadbolt or latch

Webhook Events

Key NameValue TypeDescription
eventTypeStringthe type of events
eventVersionStringthe current event version
contextObjectthe detail info of the event
deviceTypeStringthe type of the device
deviceMacStringthe MAC address of the device
lockStateStringthe state of the device, "LOCKED" stands for the motor is rotated to locking position; "UNLOCKED" stands for the motor is rotated to unlocking position; "JAMMED" stands for the motor is jammed while rotating
batteryIntegerthe current battery level, 0-100
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "WoLockPro",
        "deviceMac": DEVICE_MAC_ADDR,
        "lockState": "LOCKED",
        "battery":100,
        "timeOfSample": 123456789
    }
}