Skip to main content

Add Devices to a Physical Space

How to attach IoT devices — door locks, Wi-Fi, lights, fans, anything your adapter supports — to a physical space. Each device is registered with an adapter URL and an API key, and ZenEdge previews the device's capabilities before onboarding.

What you'll learn​

  • Opening Devices section under a physical space
  • Required inputs — adapter URL endpoint + API key (created in the adapter UI)
  • Copying the device base URL from the adapter's ZenSpace Integration panel
  • Generating an API key in the adapter system — name it (e.g., "integration"), copy it once
  • Clicking Preview Capabilities to see what the device exposes:
    • Device type (door, Wi-Fi, …)
    • Criticality — Critical devices block bookings if down
    • Protocol version, web capability, HTML embed
    • External actions (e.g., unlock, status) — customer-facing
    • Internal actions (lock, unlock, change status, audit logs) — admin-facing
  • Confirm and Onboard to attach the device
  • Adding multiple devices (the demo adds a door and Wi-Fi)
Read the transcript

00:00 — This tutorial shows how to add devices to your physical space — door, Wi-Fi, lights, fans — anything your adapter supports.

00:16 — Open the physical space → Devices section. No devices yet. Click Add Device. It asks for two things: adapter URL endpoint and API key.

00:45 — Get them from the adapter UI (configurations covered in the separate adapter series).

00:59 — Click the door device in the adapter UI. Status is Online. Scroll to ZenSpace Integration → copy the device base URL → paste into ZenEdge.

01:17 — Back to the adapter → API key isn't created yet (it must be constant across the integration). Generate a new key — name it "integration" — copy it. Store it somewhere safe.

01:56 — Paste the API key into ZenEdge → click Preview Capabilities. ZenEdge shows: type = door, criticality = critical (treated separately — if down, functionality breaks), version 1, web-capable, HTML embedded, external actions = unlock & status, internal actions = lock/unlock/change status/audit logs.

02:31 — Click Confirm and Onboard. The device is now connected to the physical space and can be used for meeting bookings.

02:44 — Add a Wi-Fi device — same flow. Adapter → Devices → Wi-Fi → ZenSpace Integration → copy device base URL → paste into ZenEdge → preview capabilities (type = Wi-Fi, criticality = standard) → Confirm and Onboard.

03:22 — You can add any device this way.

03:27 — You've successfully added devices to your physical space, including door and Wi-Fi, and confirmed their connection and capabilities.

Prerequisites​

  • Booking Access Retry — how ZenCore handles failures on critical devices like the ones added here