Skip to content

Xero

Connect Xero when your organization wants to work with accounting and Xero Projects data from Eos. The accounting webhook, direct Xero skills, and scheduled Xero Projects Agent are separate choices. You can use any of them after connecting, depending on what you want to accomplish.

Connect A Xero Organization

You need permission to manage organization integrations in Eos and permission to authorize the Xero organization.

  1. Open Integrations.
  2. If Xero is not available, open Enable/Disable Integrations and enable it for your organization.
  3. Open Org Connections, find Xero, and choose Connect.
  4. Sign in to Xero and approve access.
  5. Eos displays the Xero organizations available to the authorized account. Select one with its radio button and choose Connect.
  6. Confirm the organization name and type shown on the connected tile.

One Xero organization can belong to only one Eos organization at a time. If it is already connected elsewhere, Eos refuses the new connection. You can ask Eos to notify the current connection owner. The owner can then choose to reveal your name and email address and contact you directly.

Existing Xero connections created before Xero Projects support was added must reconnect once to grant Projects access. Reconnecting does not broaden the accounting webhook beyond the four groups described below.

Enable Automatic Accounting Imports

Select Enable webhook imports for this org on the Xero tile. Review the confirmation window, then choose Enable webhook imports.

The checkbox covers only:

  • Xero contacts as Eos companies
  • Xero contact persons as Eos contacts
  • ACCREC sales invoices and their line items
  • ACCRECCREDIT credit notes and their line items

Changes made in Xero normally appear in Eos within a few minutes. Eos keeps the Xero identity on each imported record so a later change updates the same Eos record.

The webhook is one-way. It does not send changes from Eos to Xero. Turning it off stops future automatic accounting imports but does not disconnect Xero, disable Xero skills, or delete records already imported.

Pull Xero Projects With The Marketplace Agent

Xero does not send Projects data through its accounting webhook. Eos can still pull that data from the Xero Projects API by running a scheduled Agent.

Use the Scheduled Xero Projects Sync template in Marketplace. Its default schedule runs every four hours and pulls:

  • active and closed Xero projects into Eos projects
  • Xero project tasks into Eos tasks
  • Xero project users for member mapping
  • Xero project time entries into Eos time logged

The Agent maps Xero users only to existing Eos members. It does not create members. Any user it cannot identify is reported so an administrator can resolve the mapping.

To use the template:

  1. Open Marketplace and select Scheduled Xero Projects Sync.
  2. Add the template to your organization.
  3. Open the resulting draft in Agents.
  4. Confirm that the Xero tile is connected and that the connection includes Xero Projects access. Reconnect Xero if Eos asks for the Projects scope.
  5. Review the intent and four-hour UTC schedule.
  6. Build the Agent, inspect its interpretation, and run a simulation.
  7. Make it Active when the test result and mappings look correct.

This Agent is also one-way: it copies Xero Projects data into Eos but does not push Eos changes back to Xero. You can edit its schedule or copy the template and narrow the intended projects if your organization needs a different operating rhythm.

Use Xero Skills Directly

Direct skills operate on Xero without requiring the webhook or an Eos copy. From Eos Chat, you can ask for work such as:

  • “List active Xero projects.”
  • “Show the tasks and time entries for this Xero project.”
  • “Create a task in this Xero project.”
  • “Update this Xero project’s status.”
  • “Log this approved time in Xero.”
  • “Create or send this Xero invoice.”

Xero Projects skills can list and retrieve projects, tasks, users, and time entries. They can also create or update projects, project tasks, and time entries, change project status, and delete eligible project tasks or uninvoiced time entries.

A read skill can display Xero data in the conversation without saving it in Eos. If you want an Eos copy, ask Eos to create or update the corresponding record using the result and preserve its Xero identity. The dedicated Sync Xero Projects into Eos skill performs the broader one-way import used by the Marketplace Agent.

Skills that write to Xero change the connected Xero organization. Confirm the organization, project, task, time entry, or invoice before approving the action.

Build Your Own Xero Agent

You can use the same skills in a custom Agent. Examples include:

  • pull Xero project time and compare it with Eos delivery forecasts
  • copy selected Xero projects into Eos on a custom schedule
  • create Xero project tasks after an Eos approval
  • prepare a billing check from Xero invoices and Eos project records
  • push approved Eos time to Xero while keeping the accounting webhook one-way

State the direction explicitly in the Agent intent. Automatic webhook imports never push to Xero, but a Xero write skill can do so when the Agent calls it. Build, review, and simulate any Agent that writes to Xero before making it active.

Avoid Duplicate Or Circular Updates

The Marketplace Agent recognizes records by their saved Xero identity. A custom Agent that copies Xero data into Eos should do the same: update a linked Eos record when one exists instead of creating a new record every run.

If a custom Agent also pushes changes to Xero, define which system owns each field and when an outbound write is allowed.

Troubleshooting

  • If no Xero organizations are listed, confirm that the signed-in Xero account can access the organization and restart the connection.
  • If the organization is already connected, use the owner-notification option rather than connecting it to a second Eos organization.
  • If accounting changes do not appear, confirm the webhook checkbox is on.
  • If Xero Projects skills report missing scope, reconnect Xero once and approve Projects access.
  • If a project user is unresolved, add or correct the Eos member and its matching identity or email, then run the Agent again.
  • If the Marketplace Agent does not run on schedule, confirm that it is Active and that its schedule remains enabled.