Pull your Xero Practice Manager jobs into your systems

What you can build on XPM

• Get current jobs

  Build this

  Reads your current jobs with each job's client, state, start and due dates, manager and partner.

  Takes

  State (optional), manager (optional)

  Returns

  Job number, job name, client, state, start date, due date, manager, partner

• Get timesheet entries for a date range

  Build this

  Reads the time entered against jobs between two dates, optionally for one staff member, with the task, minutes and whether it is billable.

  Takes

  From date, to date, staff member (optional)

  Returns

  Date, staff member, job number, task, minutes, billable, note

• Get invoices by status

  Build this

  Reads your invoices with their type, status, job and amounts, including what has been paid and what is outstanding.

  Takes

  Status (optional), from date (optional)

  Returns

  Invoice number, type, status, client, job number, date, due date, amount including tax, amount paid, amount outstanding

• Create a job for a client

  Build this

  Adds a job for a client you name, with its name, template, start and due dates, and the manager and partner assigned to it.

  Takes

  Client, job name, template, start date, due date, manager, partner

  Returns

  Job number, job name, client, state, start date, due date

Automate XPM with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Jobs due this week, by manager

  Build this

  Starts

  Every Monday at 7:00

  Step 1

  Get the current jobs with their state, due date and manager.

  Step 2

  Keep the jobs with a due date in the next 7 days.

  Step 3

  Email you the list, one section per manager.

• Last week's timesheets, totalled per staff member

  Build this

  Starts

  Every Monday at 9:00

  Step 1

  Get the timesheet entries from last Monday to Sunday.

  Step 2

  Add up billable and non-billable minutes for each staff member.

  Step 3

  Email you the totals, with the jobs each person entered time on.

• Overdue invoices, posted to your collections system

  Build this

  Starts

  Every weekday at 8:00

  Step 1

  Get the invoices in Approved status.

  Step 2

  Keep the ones past their due date with an amount outstanding that were not there on the last run.

  Step 3

  Post each one to your webhook with client, job number and amount outstanding.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get current jobs” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "practicemanager.xero.com/get_current_jobs",
    "input": {
      "state": "Planned"
    }
  }'

{
  "status": "completed",
  "data": {
    "jobs": [
      {
        "job_number": "J000412",
        "job_name": "Annual accounts 2026",
        "client": "Acme Holdings Ltd",
        "state": "Planned",
        "start_date": "2026-11-16",
        "due_date": "2026-12-11",
        "manager": "Manager A",
        "partner": "Partner A"
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

XPM’s own options

Xero publishes a Practice Manager API, version 3.1, that reads and writes clients, jobs, tasks, time, invoices and more in XML or JSON. Only registered Xero app partners can use it: an app cannot request Practice Manager scopes until the partner has started a security self-assessment questionnaire. Version 3.0 retires on 30 April 2027.

Read on November 12, 2026: Xero Practice Manager API 3.1 overview, Practice Manager 3.0 (deprecated), Xero Partner Hub + Practice Management.

Signing in to XPM

XPM has no sign-in page of its own: practicemanager.xero.com sends you to Xero's login, which asks for your email address and password, the same Xero account you use elsewhere. With Fous you sign in once through that login with your own account. The login is sealed with AES-256, and code and AI agents never see it.

Worth knowing

The API is for registered app partners

Before an app can request Practice Manager scopes, its developer must register as a Xero app partner and start a security self-assessment questionnaire.

Version 3.0 stops working on 30 April 2027

Practice Manager 3.0 is deprecated. Version 3.1 replaces integer identifiers with UUIDs and adds JSON, so integrations built on 3.0 need changes.

Job lists by date cover one year at most

In the API, listing all jobs takes a from and to date at most one year apart, so a full history comes in yearly slices. Current jobs come in one list.

A 200 response can still carry an error

Xero notes that some Practice Manager API requests return HTTP 200 even when errors occurred, with Status set to ERROR and an ErrorDescription in the body.

More in Accounting, tax and ERP software

• CONTPAQi
• Comarch ERP Optima
• Cegid Loop
• Domínio Sistemas
• a3innuva
• Confirmation
• MyCodabox
• Xero bank feeds
• Exact Online
• Twinfield
• Sage Intacct
• CCH Axcess
• TallyPrime
• TaxDome
• Drake Tax
• Dext Prepare
• Lexware Office
• MYOB Business
• 弥生会計
• SAP Concur

Other industries: Justdial for Business, NAPA PROLink, NNAnet, Paychex Flex, SOKA-BAU Online-Service, NuORDER.