Adding tags to Blecon Track
Before a tag 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 tags one at a time during setup or testing |
| Scan links | Third parties (suppliers, staff) registering tags without a Blecon account |
| Tracker API | Bulk registration or integration with your own systems |
Track UI
The quickest way to add a tag 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 tag. The Blecon Agent reads the tag ID via Bluetooth or NFC.
- The tag 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 tag 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 tag. Every tag 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:
- Tags are being registered at a supplier's facility before shipping
- Goods-in staff need to register tags 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 tag IDs upfront, create assets directly:
POST /tracker/api/workspaces/{workspace_id}/assets
Include the tag 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; tags 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.