Skip to main content

Event Payload Details

This provides the structure of the response sent as a payload to the webhook URL mentioned in the create subscription call.

Event Payload attributes:

Attribute NameAttribute TypeDescription
idUUIDDatabase table primary ID
eventTimeTimestampEvent timestamp
domainstringEvent category or type (LockEvent, MobileEvent, KeyEvent, etc.)
eventstringEvent sub-category or sub-type (Lock/Unlock, Checkout, Checkin, etc.)
dataJSONEvent associated details (keySN, lockSN, userID, storeID, result, etc.)
resultstringResult state as per the data
errorCodestring
entityIdstringEntity ID (Lock SN, User Id, Key SN, etc.)
entityNamestringEntity Name (Lock Name, User Name, Key Name, etc.)
operatorJSONThis generally contains the details of the user performing an action such as login/logout, checkin/checkout, lock/unlock, etc.
UserFullNamestringAssociated user's full name configured in the access manager
createdAtTimestampDatabase record creation timestamp
store_idIntegerStore or site database ID
shiftLengthIntegerUser shift length as configured in the access manager, e.g., 8 hrs, 12 hrs, 24 hrs, etc.
userTypestringUser type as configured in the access manager, e.g., User, Admin, etc.
deviceZonestringDevice's (LIVE Lock, Lock) mapped zone name as configured in the access manager
deviceNamestringDevice's (LIVE Lock, Lock) name as configured in the access manager
deviceDescriptionstringDevice's (LIVE Lock, Lock) description as configured in the access manager
sounderEnabledBoolean
eventModestring
descriptionstringFormatted or parsed message description based on all the info in the event payload

Sample Event Payload Structure :

  • Parsed or formatted one
  • Reference: Lock event
{
"id": "003b2c62-d4e8-0033-0007-4be538e39261",
"eventTime": "2023-01-20 18:05:45+05:30",
"domain": "LockEvent",
"event": "Lock/Unlock",
"entityName": "New Device, 2023-01-20, 07:27:03",
"operator": {
"id": "1",
"fullname": "Test X",
"username": "akash",
"employeeid": "123456"
},
"UserFullName": "Test X",
"store_id": 2,
"shiftLength": 8,
"userType": "Admin",
"deviceZone": "Zone 1",
"deviceName": "New Device, 2023-01-20, 07:27:03",
"deviceDescription": "",
"description": ""
}