Adding devices to Blecon Track
Before a device appears on the map, it needs to be added to your workspace. There are three ways to do this — pick the one that fits your workflow.
| Method | Best for |
|---|---|
| Track UI | Adding devices one at a time during setup or testing |
| Scan links | Third parties (suppliers, staff) registering devices without a Blecon account |
| Tracker API | Bulk registration or integration with your own systems |
Track UI
The quickest way to add a device is directly from your workspace.
- Click Scan Asset in the workspace sidebar.
- If you're on a desktop, a QR code appears — scan it with your phone to open the scanner.
- Hold your phone near the device. The Blecon Agent reads the device ID via Bluetooth or NFC.
- The device is added to your workspace and will appear on the live map as soon as a hotspot detects it.
You can add a name, type, and tags during or after registration from the asset detail page.
Scan links
Scan links let you delegate device registration to suppliers, warehouse staff, or any third party — without giving them a Blecon account.
You create a scan link in Track and share it as a URL or QR code. The recipient opens it on their phone and scans each device. Every device they register lands in your workspace immediately, with any tags, type, and name prefix you configured on the link.
This is the right option when:
- Devices are being registered at a supplier's facility before shipping
- Goods-in staff need to register devices on arrival without IT involvement
- You're deploying across multiple sites with different teams
See Scan links for setup instructions.
Tracker API
For bulk registration or programmatic workflows, use the Tracker API.
If you know the device IDs upfront, create assets directly:
POST /tracker/api/workspaces/{workspace_id}/assets
Include the device ID, name, type, and any tags or metadata in the request body. See the Tracker API reference for the full schema.
If you want to use the Blecon Agent scanner in your own app, create a scan session:
POST /tracker/api/workspaces/{workspace_id}/scan-sessions
This returns a session token and scanner URL. Open the URL on a phone to start scanning — devices are registered to your workspace as they're scanned. You can embed this flow in your own application using the scanner callback mechanism.
See the Tracker API reference and API keys for authentication.