Add a single device
Create one device record manually before the device contacts the server.
Use this flow to create one device record manually in Device Management.
When to use this flow
Use manual add when:
you need to create one device record
the device record must exist before first contact
you already know the target hierarchy and reference set
If you need to add many devices at once, use Bulk import devices.
Use the manual flow for the right cases
Manual add works best when:
one device needs careful review before save
the device data is not part of a prepared import file
the placement or reference set needs a deliberate one-device check
Before you start
Confirm that:
your role allows device creation
the device does not already have a record in Device Management
you know where the device should be placed
the required reference set is ready for that device
Prepare these details:
Serial Number
Device ID
Model
target Hierarchy
target Reference set
Required field checks
Review each value before you enter it:
Serial Number identifies the physical device
Device ID must match the intended managed record
Model must match the real device model
Hierarchy controls ownership and visibility
Reference set controls the intended device baseline
Validate the device details
Before you save the record, confirm that:
the Serial Number and Device ID belong to the same device
the device identifiers are not already used by another record
the selected Model matches the physical device
the target Hierarchy is the correct placement for the device
the selected Reference set matches the intended configuration
Search for both identifiers before you enter them. Stop if either identifier already returns a record.
Do not use this flow if the device should create its own record during first contact.
Add the right record
Use this flow to create the record only once.
If the device already exists in Device Management, stop and verify the existing record instead of creating another one.
Add the device
Verify the saved values
After the record is created, confirm these fields on the saved device:
Serial Number
Device ID
Model
Hierarchy
Reference set
If any value is wrong, correct it before the device starts registration work.
Record the device ID and selected hierarchy in the deployment handoff. This lets the installer confirm they are registering the intended record.
If the device does not save as expected
Check these first:
a required field is not blank
the identifiers are unique
the selected hierarchy is valid for your scope
the reference set is available for the target device
If the save succeeds but the record looks wrong, review the saved device in Device details before the device contacts the server.
Common outcomes
Use these checks to narrow the issue:
The record is not created — review missing or invalid values and submit again
The device appears in the wrong place — correct the selected hierarchy before registration
The record exists but registration later fails — review Registering the device and Device heartbeats
The record matches another physical device — stop deployment and resolve the identifier mismatch before registration
Result
The device record is added with the intended identifiers, placement, and reference set.
Next steps
Registering the device — complete first-time registration
View devices — review the new device record
Device details — confirm the saved device values
Bulk import devices — add many devices instead
Last updated
Was this helpful?




