Exporting from Microsoft 365 users
The Microsoft 365 active users export is the most reliable count of the people you support at each client, and it carries the licences each one holds. Headroom compares it with each agreement and with your billing lines.
Microsoft rearranges the admin centre from time to time. If Export users is not where this guide says, look under the More actions menu on the Active users page.
Users & devices
- In the Microsoft 365 admin centre for the client's tenant, go to Users, then Active users.
- Choose Export users (in some layouts it sits under the More actions menu). The file is a CSV of every account.
- Repeat for each client tenant you manage, then combine the files into one, or upload one per client.
| Column in your export | Headroom field |
|---|---|
| User principal name | NameRequired |
| Licenses | Licence |
| When created | First seen / created |
Column names are the usual defaults. Yours may differ if the list or report has been customised.
Add before uploading
This export doesn't include these required fields: Client, Type (user / device). Add them as columns in the spreadsheet.
Microsoft's export has no client or type column. Add a Client column holding the client's name exactly as in your clients file, and a Type column holding user on every row.
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 accounts that are not people you support: shared mailboxes, room and equipment mailboxes, service and break-glass accounts, and unlicensed accounts you don't bill for. Left in, they count as users.
- Remove accounts with Block credential set to True: they are blocked from signing in. Don't map Block credential to Status; its True or False doesn't read as active or inactive.
- The Licenses column can hold several licences in one cell. Headroom compares a user's licence with your billing line names, so keep the licence you bill for (for example Microsoft 365 Business Premium) and make it match the billing line's name.
- When created is the account's creation date. It lets Headroom count each user from the month they were added.
- 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
- RMM device listsHow to export a device list from an RMM such as NinjaOne, Datto RMM or N-able 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.