About Services Tools Blog Contact us

Cloud Accounts Backup

Backs up a Xero organisation in stages that can be paused and resumed, and keeps the archive outside the public website folder.

  • Scheduled Workers & Sync
  • Professional services
  • Scheduled worker
  • Productised
  • Local/private
  • 2026

The problem

Xero holds the only copy of the books, so a lockout or a mistake leaves no local archive. One long download times out halfway and has to start again from the beginning. A missing permission fails the whole run when it should only skip that one section.

What it does

A person starts the backup from the admin screen. The tool works through each type of record a page at a time and notes its progress after every page. It stops when the time allowance runs out, and the person resumes it later. Missing permissions are listed and those parts are skipped, and the finished archive can be downloaded.

Outcomes

  • A local archive exists outside the public website folder.
  • A run that times out resumes where it stopped.
  • Two backups cannot run at once.
  • A missing permission skips one section and the rest still run.

Simplified mockup

Interactive preview with sample data. Nothing is sent to a server.

Accounts backup

Organisation
Harrow & Vale
practice books
Time budget
20 s
then pause and resume
Lock
Free
no runner active
Entities
SectionRowsState
Organisation0pending
Contacts0pending
Invoices0pending
Payments0pending
Bank lines0pending
Files0pending
Payroll0pending
Runner
20 second budget. Manifest after every page.

Resume 2026-10-09_141204

missing scopes Payroll employees, pay runs and payslips are not on the token. That section will be skipped, not failed.
Manifest so far
SectionRowsState
Organisation1done
Contacts412done
Invoices186page 2
Payments0pending
Bank lines0pending
Files0pending
Payroll0no scope
Continue
Starts from invoices page 3, not from the top.

Runner already going

running
Backup
09:15:02
lock held
Current page
Invoices
page 1 of 11
Second runner
Blocked
until this one finishes
Attempt
The 09:15 backup is still paging invoices.

How it works

  1. Start the backup from the admin screen.
  2. Work through each type of record a page at a time, noting progress after every page.
  3. Stop when the time allowance is used up, and allow a resume.
  4. Refuse to start a second run while one is going.
  5. Reuse attachments that are already stored.
  6. List missing permissions, skip those parts and offer the archive for download.

Pipeline

flowchart LR
  Start["Start backup"] --> Page["Page entities"]
  Page --> Manifest["Manifest"]
  Page --> Budget{"Time left"}
  Budget -->|no| Resume["Resume later"]
  Budget -->|yes| Archive["Downloadable archive"]
  Running["Already running"] --> Stop["Refuse second run"]