2025.10.0
Home ▸ Integrations ▸

ekey bionyx

The ekey bionyx integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows Home Assistant to receive events from your ekey fingerprint reader.

Prerequisites

  • The ekey bionyx app.
  • The ekey device needs to be set up in plus mode in the app.
  • The ekey bionyx Third-Party API needs to be enabled in the app.

Activate ekey bionyx Third Party API

Configuration

To add the ekey bionyx integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select ekey bionyx.

  • Follow the instructions on screen to complete the setup.

Tip

Prefer using local IPs when setting up the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] instead of domain names because the events will be more responsive.

Once the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] is added, open the ekey app and assign events to the fingers you wish to use as triggers.

Supported functionality

The ekey bionyx integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following entities.

Events

The functions defined during setup are represented in Home Assistant as events. You can use these events as triggers in automations.

Limitations

  • The ekey integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows only five functions per ekey system.
  • You cannot link multiple Home Assistant instances to the same ekey system.

Removing the integration

Based on the limited lifetime of the token, you have two options for cleanly resetting the connection to Home Assistant:

  • Delete the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] in Home Assistant, set it up again (triggering the deletion process), and abort when you are in the step of naming the functions.
  • Delete the integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] in Home Assistant, then disable and re-enable the Third-Party API in the ekey app (this resets all functions and webhooks, even outside of Home Assistant).