Notification Webhook Objects that are access control related will have the Access Control Events Webhook Object as their data attribute. All events that you would see in the Access Control reports section on Command will flow through this webhook as well. Below we have outlined all relevant objects that are nested in the Access Control Webhook data payload.

Access Control Notification Object

Attribute	Type	Description
webhook_type	String	"notification"
webhook_id	String	Verkada defined Id for notification webhook
org_id	String	Organization Id from which webhook is created.
created_at	Integer	Time at which webhook was created. Measured in seconds since the Unix epoch.
data	Main Access Webhook Object	See Below.

Main Access Webhook Object

Attribute	Type	Description
device_id	String	The Verkada ID of the access control object associated with the event.
created_at	INT	The Epoch timestamp of the event.
notification_type	String	The type of Access Control Event.
input_value	String	The Input value associated with the relevant event.
door_id	String	The ID of the device that triggered the access event.
aux_info	Object	The information about the AUX device that caused this access event, if one was present.
user_info	Object	The information about the user associated with this access event, if one was present.
lockdown_info	Object	The information about the lockdown triggered on this access event, if one was triggered.
door_info	Object	The information about the door associated with the access event.

Aux Information Object

Attribute	Type	Description
aux_input_id	String	The ID of the AUX that triggered the event.
aux_input_name	String	The name of the AUX that triggered the event.

User Information Object

Attribute	Type	Description
user_id	String	The ID of the user that triggered the event.
name	String	The name of the user that triggered the event.
email	String	The email of the user that triggered the event.
first_name	String	The first name of the user that triggered the event.
last_name	String	The last name of the user that triggered the event.
phone	String	The phone number of the user that triggered the event.

Lockdown Information Object

Attribute	Type	Description
lockdown_id	String	The ID number of the lockdown associated with the event.
lockdown_name	String	The name of the lockdown associated with the event.
message	String	The message of the lockdown associated with the event.
action	String	The action on the lockdown associated with the event.
enabled	String	Boolean indicating whether the lockdown has been enabled.

Door Information Object

Attribute	Type	Description
acu_name	String	The name of the ACU to which the door is attached.
acu_id	String	The ID of the ACU to which the door is attached.
name	String	The name of the door.

Example Payloads

Key Card Rejected Event

{
  "org_id": "a74fc6a6-4fc5-4e5c-88e5-57301683327a",
  "webhook_type": "notification",
  "created_at": 1692131003,
  "webhook_id": "457eb610-03b4-4fa0-a8c7-c06f3142df50",
  "data": {
    "device_id": "dd47e8e4-dc18-47d9-8249-4607eaa884dd",
    "created": 1692131000,
    "notification_type": "door_keycard_entered_rejected",
    "device_type": "access_control",
    "door_id": "dd47e8e4-dc18-47d9-8249-4607eaa884dd",
    "input_value": "151|39924",
    "aux_info": null,
    "user_info": null,
    "lockdown_info": null,
    "door_info": null
  }
}

Door Remote Unlock Accepted Event

{
  "org_id": "a74fc6a6-4fc5-4e5c-88e5-57301683327a",
  "webhook_type": "notification",
  "created_at": 1692235651,
  "webhook_id": "60a168de-df82-40bb-b31e-a7fd7c49d79d",
  "data": {
    "device_id": "a1faa47c-330a-45aa-8fe6-cacb293400c2",
    "created": 1692235647,
    "notification_type": "door_remote_unlock_accepted",
    "device_type": "access_control",
    "door_id": "a1faa47c-330a-45aa-8fe6-cacb293400c2",
    "input_value": null,
    "aux_info": null,
    "user_info": {
      "user_id": "47c39a50-3575-40ee-bfe9-46e0fa8447db",
      "name": "John Smith",
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Smith",
      "phone": "+1234567890"
    },
    "lockdown_info": null,
    "door_info": {
      "acu_name": "Lobby Door Controller",
      "acu_id": "8adf16e0-a52a-45d1-8b68-efc5d6fb64ba",
      "name": "Front Door"
    }
  }
}