QuickBooks Online
Connect QuickBooks Online when your organization wants to work with accounting data from Eos. The connection supports two separate ways of working: optional automatic imports into Eos, and skills or agents that work directly with QuickBooks.
Turning on automatic imports is optional. A connected organization can use QuickBooks skills even when webhook imports are off.
Connect QuickBooks Online
You need permission to manage organization integrations in Eos and permission to authorize the QuickBooks company.
- Open Integrations.
- If QuickBooks Online is not available, open Enable/Disable Integrations and enable it for your organization.
- Open Org Connections and find QuickBooks Online.
- Choose Connect.
- Sign in to Intuit and authorize the QuickBooks company you want Eos to use.
- Return to Eos and confirm that the tile says Connected. Check the company shown on the tile before using accounting skills or enabling imports.
The connection belongs to the active Eos organization. Disconnecting it stops QuickBooks skills and future imports, but does not delete records that were already added to Eos.
Enable Automatic Imports
After connecting, select Enable webhook imports for this org on the QuickBooks tile. Review the list in the confirmation window, then choose Enable webhook imports.
When enabled, Eos automatically brings over changes for:
- QuickBooks customers as Eos companies
- QuickBooks items as Eos products
- QuickBooks employees as mappings to existing Eos members
- invoices and invoice line items
- credit memos and their line items
- time activities as Eos time logged
QuickBooks employee records do not create new Eos members. Eos links an employee only when it can identify one existing member. Add the person to Eos first if no matching member exists.
What The Webhook Does
The webhook is a one-way automatic import from QuickBooks to Eos. You do not have to run a sync whenever a customer, invoice, credit memo, item, employee, or time activity changes. The update normally appears in Eos within a few minutes.
Eos keeps the QuickBooks identity on the imported record so later notifications update the same record instead of creating another copy.
The webhook never sends an Eos change back to QuickBooks. Turning the checkbox off stops future automatic imports for this Eos organization. It does not disconnect QuickBooks, disable QuickBooks skills, or remove records already imported.
Use QuickBooks Skills Without Importing Everything
Skills let Eos work with the live QuickBooks company directly. This is useful when you need an answer or a provider-side action but do not want a permanent Eos copy of every record.
From Eos Chat, you can ask for work such as:
- “Find the QuickBooks customer called Northwind.”
- “Show unpaid QuickBooks invoices for this customer.”
- “Run this month’s QuickBooks Profit and Loss report.”
- “Compare this month’s Profit and Loss with last month.”
- “Create or update this mapped QuickBooks customer.”
- “Update this mapped invoice in QuickBooks.”
Available skills can query mapped customers, products, employees, invoices, credit memos, and time activities; retrieve one mapped object; create or update supported QuickBooks records; and run accounting reports and analyses.
A read skill can show the QuickBooks result in the conversation without saving it in Eos. If you want an Eos record as well, ask Eos to create or update the corresponding company, product, invoice, credit note, member mapping, or time entry using the returned data. Eos can preserve the QuickBooks identity on that record so later work can find the relationship.
Skills that write to QuickBooks change the connected accounting company. Review the company, record, and proposed values carefully. Approval-controlled actions remain subject to the approval shown in the conversation or agent run.
Use QuickBooks In An Agent
An Agent can combine QuickBooks skills with normal Eos skills. For example, an Agent can:
- read invoice or customer data from QuickBooks and prepare an Eos report
- find overdue QuickBooks invoices and create follow-up tasks in Eos
- use approved Eos time entries to prepare or update provider-side records
- compare QuickBooks financial results with Eos project-delivery data
- retrieve a QuickBooks object, add or update its Eos equivalent, and keep their external identities linked
Describe both direction and scope in the Agent intent. Say whether it should only read QuickBooks, write to QuickBooks, create Eos records, or do a combination. For financial writes, include the conditions that must be met and any approval you require.
Before activating a scheduled or unattended Agent, Build it, review its interpretation, and Simulate it with a small and recognizable set of records. See Agents.
Avoid Duplicate Or Circular Updates
Do not combine a broad QuickBooks-to-Eos webhook import with an Agent that repeatedly creates the same Eos records without checking their external identity. When an Agent copies a record, have it update the linked record when one exists.
If an Agent also writes changes back to QuickBooks, define which system owns each field. This prevents a provider update from being imported into Eos and then immediately written back unnecessarily.
Troubleshooting
- If Connect is unavailable, confirm that QuickBooks is enabled for the organization and that you can manage integrations.
- If the wrong company is shown, disconnect and reconnect to the intended QuickBooks company before running skills.
- If automatic changes do not appear, confirm the webhook checkbox is still on.
- If an employee is not mapped, confirm that the Eos member already exists and uses the matching identity or email address.
- If a skill cannot access QuickBooks, reconnect the integration and retry after confirming the connected company.