---
title: Nuki lock and KNX integration with Link’nX
description: "Control a Nuki lock with Link’nX: unlock, lock, unlatch and Lock 'n' go in scenarios that can start from KNX, with step-by-step setup guides."
canonical: https://wiki.can-nx.com/en/integrations/nuki/
language: en
---

# Nuki lock and KNX integration with Link’nX

With Link’nX, a Nuki lock is controlled from the installation’s scenarios: unlock, lock, unlatch or run Lock 'n' go. The scenario can start on a KNX write, for example a press on a push button mapped to a group address. This page sums up what the integration does and the commissioning order.

## What the Nuki integration does

| Need | Where to configure it | Guide |
| --- | --- | --- |
| Declare the lock with its identifier and API key | **Devices → Security & Access → Nuki** | [Declare a Nuki lock](https://wiki.can-nx.com/en/guides/link-nuki/) |
| Unlock or lock from a scenario | **Nuki** action, **Unlock** and **Lock** commands | [Prepare a Nuki action](https://wiki.can-nx.com/en/guides/link-nuki/) |
| Unlock and open the latch | **Unlatch** command | [Prepare a Nuki action](https://wiki.can-nx.com/en/guides/link-nuki/) |
| Lock again after a delay | **Lock 'n' go** command, with or without unlatch; delay set in the Nuki lock’s settings | [Prepare a Nuki action](https://wiki.can-nx.com/en/guides/link-nuki/) |
| Run the command from the KNX bus | Scenario with a **KNX** trigger | [Create a KNX trigger](https://wiki.can-nx.com/en/guides/link-trigger-knx/) |

## Step-by-step commissioning

1. [In Nuki Web](https://wiki.can-nx.com/en/guides/link-nuki/), note the lock’s identifier and generate an API token with the **Manage devices** right. Check that the Nuki entry is available in the project and the gateway ([navigation and options](https://wiki.can-nx.com/en/guides/link-navigation/)).
2. [Declare the lock](https://wiki.can-nx.com/en/guides/link-nuki/) with a **Name**, its **Lock ID** and its **API key**.
3. Prepare one **Nuki** action per useful command. Editing and duplication follow the [common actions guide](https://wiki.can-nx.com/en/guides/link-action-edit/).
4. [Add the action to the scenario](https://wiki.can-nx.com/en/guides/link-compose-scenario/) with its trigger, for example a [KNX trigger](https://wiki.can-nx.com/en/guides/link-trigger-knx/) on the button’s address.
5. Check the lock and the command, then test the scenario on the door.

If something goes wrong, the last section of the [Nuki guide](https://wiki.can-nx.com/en/guides/link-nuki/) covers a lock missing from the list and a command with no effect.

## Good to know

- The declaration needs no IP address or port: only the name and the Lock ID, 64 characters maximum each, and the API key.
- An action targets one lock. It has no Value field and no duration setting: the Lock 'n' go delay is set in the lock’s settings, from the Nuki app or Nuki Web.
- **Unlock** alone does not request opening the latch: choose **Unlatch**. Opening the latch can allow the door to open.
- Saving the declaration or the action runs no command and confirms neither the connection to the lock nor its status.
- Enter the API key only in the form, never in an e-mail or a screenshot.

For other access solutions, see [Access control](https://wiki.can-nx.com/en/usages/acces/).

## All Nuki guides

### Devices and integrations

- [Nuki smart lock in Link’nX: declare the lock and create its actions](https://wiki.can-nx.com/en/guides/link-nuki/)