QuickBooksOnline: Reconnecting Your QuickBooks Online Account

If the API connection between your Fintech account and QuickBooks Online is interrupted, your data will not sync between the systems. Interruptions can occur for a number of reasons, such as expired credentials or changes to your account.

When the connection becomes inactive, you will see the following indications across the integration detail page:

Field / Element	Description
Integration Status Badge	The badge next to the QuickBooks title changes from the green “Active” flag to a gray “Inactive” flag.
API Connection Status (top-right)	The text in the top-right corner of any tab reads “API Connection Status is Inactive” in bold red text, accompanied by a “Connect Account” link.
Connect Account Link	A blue link with a connection icon (📶) labeled “Connect Account” appears next to the Inactive status text. Clicking this link begins the reconnection process.
Vendor ID Column	On the Vendors tab, the Vendor ID column displays “Integration Account Name” placeholders instead of actual numeric IDs, indicating the data feed is not live.

Connection Link States

After a successful reconnection, the QuickBooks integration detail page displays three link state tabs below the page header. These reflect the full connection lifecycle:

Link State	Indicator Color	Meaning
Disabled Link	Gray	The integration has never been connected or has been manually disabled.
Inactive Link	Red / Orange	The API connection has lapsed or been disconnected. Reconnection required.
Active Link	Green	The API connection is live and syncing data to QuickBooks successfully.

During initial setup or while inactive, only the Inactive indicator is shown. The other link states appear on the page header after the reconnection flow has been completed at least once.

Before You Begin

Before starting the reconnection process, ensure you have the following:

Your Intuit (QuickBooks) account email address or user ID.
Your Intuit account password.
Access to any two-factor authentication method configured on your Intuit account (if applicable).
Administrator-level access to the QuickBooks company file you are reconnecting to.

⚠️ Connecting the integration to a new or separate QuickBooks account will permanently remove all existing Locations, Accounts, Vendors, and Product Assignments. Only proceed if you intend to link a different QuickBooks account. If you are reconnecting to the same account, this will restore the connection without data loss.

Step-by-Step: Reconnecting Your QuickBooks Account

Step 1 — Locate the Inactive Status and Click Connect Account

1	Navigate to Integrations → My Integrations from the left-hand navigation menu.
2	Click See Details (→) in the QuickBooks row. The QuickBooks detail page opens showing the Inactive status badge.
3	In the top-right corner of any tab, locate “API Connection Status is Inactive”.
4	Click the Connect Account link (📶 Connect Account) immediately to the right of the Inactive status text.

Step 2 — Review the Reconnect Warning and Confirm

You will be asked “Are you sure to Reconnect?” followed by a warning message that connecting to a new (or separate) account will remove all Locations, Accounts, Vendors, and Product Assignments.

To proceed, click Yes. This will open the QuickBooks login page in your browser.
Clicking No will close the dialog box and the integration will remain inactive.

Step 3 — Sign In to Your Intuit Account (Email / User ID)

The QuickBooks Online sign-in page opens in your browser. Sign in with your email, user ID, associated with your QuickBooks account. You can also use a phone number if it's linked.

Once Intuit authentication completes, you are automatically returned to the QuickBooks integration detail page in Fintech. The following changes confirm the connection has been restored:

SUCCESS

A green confirmation banner appears at the top of the page reading: “Your account has been successfully reconnected.” Click Dismiss × to close the banner.

Field / Element	Description
Integration Status Badge	Updates from “Inactive” (grey) to “Active” (green).
API Connection Status	Updates from “API Connection Status is Inactive” to “API Connection Status is Active” in the top-right corner of all tabs.
Link State Tabs	Three tabs appear below the page header: Disabled Link, Inactive Link, and Active Link — with Active Link currently selected.
Vendor ID Column	On the Vendors tab, the Vendor ID column now populates with actual numeric IDs instead of placeholder text.
Total Sync Files	The page header now shows the Total Sync Files count and the Most Recent Sync Date, confirming sync history is accessible.
Connect Account link	The Connect Account link is no longer displayed since the connection is now active.