Lock Ultra

May 16, 2026 ยท View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Smart Lock Ultra
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. Lock Ultra
hubDeviceIdStringdevice's parent Hub ID
batteryIntegerthe current battery level, 0-100
versionStringthe current firmware version, e.g. V6.3
lockStateStringjammed, unlock, lock, latchBoltLocked
doorStateStringopen, close
calibrateBooleandetermines if Lock has been calibrated or not

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Lock Ultracommandlockdefaultrotate to locked position
Lock Ultracommandunlockdefaultrotate to unlocked position
Lock Ultracommanddeadboltdefaultdisengage 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 battery level
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "Smart Lock Ultra",
        "deviceMac": DEVICE_MAC_ADDR,
        "lockState": "LOCKED",
        "battery": 90,
        "timeOfSample": 123456789
    }
}