QuickBooks shows a connection error or needs reconnecting

QuickBooks shows a connection error or needs reconnecting

QuickBooks shows a connection error or needs reconnecting

Symptom: The QuickBooks Online card shows a warning, a Reconnect pill, or a connection error, and invoices may have stopped syncing.

Read the status pill

The QuickBooks Online card header pill tells you the state:

  • Connected — healthy.
  • 30d left (amber) — the refresh token expires within 30 days; reconnect soon.
  • 14d left or fewer (red) — expiring very soon; reconnect now.
  • Reconnect — the refresh token has expired; invoicing through QuickBooks is stopped until you reconnect.

The Connected Account panel also shows a refresh-token badge: Nd, Nd left, Nd • reconnect, Reconnect soon, or Token unknown.

Expired refresh token

When the token has expired, the card shows a panel: QuickBooks needs to be reconnected with Your refresh token has expired. Reconnect to keep invoicing through QuickBooks. Select Reconnect QuickBooks and authorize again with Intuit. See [[invoicing-connect-quickbooks]].

A surfaced connection error

If QuickBooks returned an error, the card shows a red QuickBooks connection error panel with the underlying message. To re-check the live state, select Test Connection:

  • Success: Connected to <company name>, with the company name and country shown.
  • Failure: the error message QuickBooks returned is shown inline and as an error notice.

The card surfaces the error message itself rather than a status code — read that message to see what QuickBooks reported. If it points to an expired or revoked authorization, reconnect (below). If the message is unclear or persists after a reconnect, re-run Test Connection to confirm it is still failing, then contact support with the message shown.

Untrusted redirect refused

If connecting reports Untrusted QuickBooks redirect URL — refusing to navigate or No authorization URL received from QuickBooks, the authorization URL did not come back as expected. Retry Connect with QuickBooks.

After reconnecting

Reconnecting returns you to Invoicing Settings with QuickBooks connected! Verifying..., reloads settings, and runs a connection test automatically. Confirm the pill reads Connected, then verify your account mappings are still set. See [[invoicing-quickbooks-defaults-settings]].

    • Related Articles

    • How do I connect QuickBooks Online to Invoicing?

      How do I connect QuickBooks Online to Invoicing? School-to-student invoicing is QuickBooks Online-only. You connect it once from Invoicing Settings, and HangarOS uses that connection to create flight invoices. Connect QuickBooks Open Invoicing ...

    • How do I map QuickBooks accounts, terms, and the default memo?

      How do I map QuickBooks accounts, terms, and the default memo? Once QuickBooks Online is connected, the QuickBooks Online card in Invoicing Settings shows a QuickBooks Defaults form. These IDs tell QuickBooks which accounts and terms to use when ...

    • How do I finish setup so flights auto-invoice in QuickBooks?

      How do I finish setup so flights auto-invoice in QuickBooks? When an instructor ends a flight, HangarOS auto-creates an invoice in QuickBooks Online. That only works once the preconditions are met. Invoicing Settings shows a setup checklist at the ...

    • Flights are ending but no invoices are being created

      Flights are ending but no invoices are being created Symptom: Instructors are ending flights, but no invoice shows up in the Invoices list or in QuickBooks. Flight-end auto-invoicing has several preconditions. The setup checklist at the top of ...

    • Which permissions control the Invoicing module?

      Which permissions control the Invoicing module? Invoicing uses three permission keys. The * wildcard satisfies any of them. Permission keys Permission What it gates billing:view View access to the Invoicing landing page, Invoices, Payments, Student ...