---
title: "access denied · RUAL Documentation"
description: "Starts the flow when someone is refused: an unknown card, a wrong PIN, a credential outside its schedule."
canonical: https://docs.rual.nl/block-types/globals/homeassist_trigger_access_denied
language: en
---

# access denied

This block is part of the [`globals`](https://docs.rual.nl/block-types/globals) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

Starts the flow when someone is refused: an unknown card, a wrong PIN, a credential outside its schedule.

- device `v15.0.0` `value` Only fire for this door. Leave empty for every door.

- room `v15.0.0` `value` Only fire for devices in this room. Leave empty for every room.

- flow `v15.0.0` `flow`

- device `v15.0.0` `object` The full device: id, name, room, type, capabilities, current state.

- device id `v15.0.0` `value` Stable platform id, e.g. zigbee:0x00158d0007e1a2b3.

- name `v15.0.0` `value` The device's friendly name.

- room `v15.0.0` `value` The room the device is assigned to, empty if none.

- type `v15.0.0` `value` sensor, light, switch, climate, cover, lock or button.

- capability `v15.0.0` `value` Which capability changed, e.g. occupancy, contact, power.

- value `v15.0.0` `value` The new value.

- previous `v15.0.0` `value` The value before this change, empty on the first report.

- at `v15.0.0` `number` Unix seconds the device reported.

- actor `v15.0.0` `value` Who: the user or credential name, empty when the reader could not identify them.

- method `v15.0.0` `value` How: nfc, pin, wave, mobile, touchpass or manual.

- granted `v15.0.0` `condition` True when access was allowed, false when the reader denied it.

Start-of-flow trigger for a FAILED entry. Fires when an access_entry event is denied. Same out-pins as access granted, with granted=false. Use for security alerting: an unknown card at 3am is worth a notification.

| `unifi` |
| --- |
| `access` |
| `security` |
| `door` |
| `trigger` |

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).