Exporting from RMM device lists
Your RMM knows every device it manages at each client. Its device list is what Headroom compares with the devices each agreement covers. The steps are the same in NinjaOne, Datto RMM, N-able and most other RMMs.
Menu names vary by version and by how your PSA is set up, so this guide describes what to look for rather than exact clicks. If a column has a different name in your export, map it by hand when you upload: Headroom shows every mapping before it imports anything.
Users & devices
- Open the device list for all organisations, sites or customers (the name depends on the RMM).
- Choose the columns: organisation or site, device name or hostname, device type, and the date the device was added if the RMM shows it.
- Export the list to CSV.
| Column in your export | Headroom field |
|---|---|
| Organization / Site / Customer | ClientRequired |
| Hostname / Device Name | NameRequired |
| Device Type / Device Class | Type (user / device)Required |
| Created / Date Added | First seen / created |
Column names are the usual defaults. Yours may differ if the list or report has been customised.
Headroom needs each row's type to start with device, computer, laptop, desktop, server, workstation, endpoint, mobile or phone. Types such as Windows Desktop or Managed Workstation don't; set the Type column to device on every row before upload.
Date range
- Export three to six months of tickets and time entries, ending with the last full month. Use the same start and end date for both: the analysis period is the months those dates span.
- Fewer than three months gives too little to compare; more than six makes old agreements and leavers more likely to blur the picture.
- The clients file, users and devices, and billing lines describe what is in place now: current agreements, active users and devices, and current recurring charges. They have no date range.
- Users and devices with a created or first-seen date let Headroom tell when each one was added, so a monthly figure reflects when growth happened.
Before you upload
- Remove devices that haven't checked in for 30 days or more, and anything you don't support under the agreement, such as network gear or printers if your agreements count only computers and servers.
- If a client has several sites in the RMM, give them all the client's name so they count together.
- Personal devices: if your RMM can tell company-owned from personal devices, keep that column and map it to Ownership. It helps Headroom check personal-device clauses.
- Dates are read as day/month/year or year-month-day, with or without a time. If your export writes dates month first (US style, 03/14/2026), change the column's date format in the spreadsheet before uploading.
- Client names must match across every file. Headroom ignores case, spaces and punctuation ("ABC Ltd" and "abc ltd." match) but not different names ("ABC" and "ABC Holdings"). Rename in the spreadsheet before upload if your RMM or Microsoft 365 uses a different name.
Next steps
With the files ready, create a free account and upload them. Headroom shows how it has mapped every column before it imports anything, and you can change any mapping.
A guided audit is a 45-minute call where we help you run these exports. Or explore the demo to see what the files turn into.
Other guides
- ConnectWise PSAWhich ConnectWise PSA lists and reports give Headroom its clients, tickets, time entries and billing lines, and how the columns map.Clients, Tickets, Time entries, Billing / agreements
- Autotask PSA (Datto)Which Autotask PSA searches and reports give Headroom its clients, tickets, time entries and billing lines, and how the columns map.Clients, Tickets, Time entries, Billing / agreements
- HaloPSAWhich HaloPSA lists and reports give Headroom its clients, tickets, time entries and billing lines, and how the columns map.Clients, Tickets, Time entries, Billing / agreements
- SyncroWhich Syncro lists give Headroom its clients, tickets, time, assets and billing lines, and how the columns map.Clients, Tickets, Time entries, Users & devices, Billing / agreements
- Microsoft 365 usersHow to export active users and licences from the Microsoft 365 admin centre for Headroom's users and devices file.Users & devices
Headroom is a trading name of A-IT & Cyber Group Ltd, registered in England and Wales (company number 17473234). Registered office: 26 Balston Road, Poole, BH14 0QH.