Exporting from Autotask PSA (Datto)
Autotask PSA holds four of the five files Headroom reads. Its search pages and reports can export to a spreadsheet; choose the columns first, then export.
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.
Clients
- Use a contract search filtered to active recurring service contracts. It gives the organisation, contract name and dates.
- Add a Monthly recurring revenue column: the monthly total of each client's recurring services. Autotask shows that per contract, so total it per organisation in the spreadsheet.
- Add Contracted users and Contracted devices columns if you price per user or device, using the units on the contract's services.
| Column in your export | Headroom field |
|---|---|
| Organization | Client nameRequired |
| Contract Name | Package / tier |
| Start Date | Contract start |
| End Date | Contract end |
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 a required field: Monthly recurring revenue. Add it as a column in the spreadsheet.
One row per client. If a client has several recurring service contracts, combine them.
Tickets
- Use a ticket search across every queue you do client work in, including completed tickets, with the created date in your period.
- Add organisation, title, status and primary resource as columns, then export.
| Column in your export | Headroom field |
|---|---|
| Ticket Number | Ticket IDRequired |
| Organization | ClientRequired |
| Created | DateRequired |
| Title | SubjectRequired |
| Primary Resource | Technician |
| Status | Status |
Column names are the usual defaults. Yours may differ if the list or report has been customised.
Include the description if your search can show it: it gives the analysis more to read. The ticket's own hours column is best left unmapped: Headroom takes time from the time entries file.
Time entries
- Use a time entry report or search for every resource over the same period as the tickets.
- Include the date worked, organisation, resource, ticket number, hours worked and whether the entry is billable.
| Column in your export | Headroom field |
|---|---|
| Date Worked | DateRequired |
| Organization | ClientRequired |
| Resource | Technician |
| Ticket Number | Ticket ID |
| Hours Worked | MinutesRequired |
| Billable | Billable |
Column names are the usual defaults. Yours may differ if the list or report has been customised.
If your export splits time into Billable Hours and Non-Billable Hours instead of a flag, add a Billable column (Yes where billable hours are above zero) and use the total hours worked.
Billing / agreements
- Recurring charges are the services on each recurring service contract.
- Export the contract services with their organisation, service name, units and unit price. A report on contract services gives every client at once.
| Column in your export | Headroom field |
|---|---|
| Organization | ClientRequired |
| Service | Service / productRequired |
| Units | QuantityRequired |
| Unit Price | Unit priceRequired |
| Extended Price | Monthly value |
Column names are the usual defaults. Yours may differ if the list or report has been customised.
Name per-user and per-device services so the name says so ("Managed Support per user").
Contracts
- Contracts are not a report. Use the signed agreement, statement of work or service schedule for each client, as a PDF or text file.
- If your PSA stores the signed agreement as an attachment on the agreement or contract record, download it from there; otherwise use the copy in your document store.
- Start with your largest clients and any you suspect are doing work outside their agreement.
Headroom reads the clauses that decide what is billable: device ownership, hardware, project and onsite exclusions, support hours, included hours, third-party applications and new user or device setup. Scanned image-only PDFs have no text to read; use the original document or a text-based PDF.
From other systems
Users and devices come from Microsoft 365 and your RMM (Datto RMM devices sync to Autotask, but the RMM export is the more complete list). See the Microsoft 365 and RMM guides.
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
- 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.
- Autotask calls clients organisations (accounts in older versions). Either name maps to Client.
- Headroom reads time in minutes. When the column you map for time has hours in its name (Actual Hours, Hours Worked, Total hrs), a plain number in it is read as hours, in both the tickets and the time entries file, and the upload screen says so. In other columns, a decimal under 24 (1.5) in the time entries file is read as hours, and everything else is read as minutes unless it is written with h (1h 30m). If a column holds hours but its name doesn't say so, rename it or multiply the values by 60 before uploading.
- The billable column must say yes or no in a form Headroom reads: Yes, No, True, False, Billable, Non-billable or No charge. Replace other values, such as an internal code, before upload, or leave the column unmapped.
- 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.
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
- 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
- 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.