Disconnecting QuickBooks stops new syncs in both directions and pauses any in-flight events. Your historical sync record is preserved.
How to disconnect
- Settings → QuickBooks.
- Disconnect.
- Confirm.
The connection's status flips to disconnected. Future invoices, customers, and payments stop syncing to QBO.
What happens after disconnect
| Behavior | Effect |
|---|---|
| New events stop syncing | Invoices created after disconnect don't go to QBO. |
| In-flight sync events are paused | Anything queued but not yet sent halts. Reconnecting later resumes them where they left off. |
| Connection record stays | Your qb_connections row is kept with the disconnected status, including past sync history, mappings, and configuration. |
| OAuth token is invalidated | You'll need to re-authorize if you reconnect. |
What does NOT happen
| Behavior | Detail |
|---|---|
| Past synced data is not removed | From QBO. Invoices, payments, customers already over there stay where they are. |
| Mappings (items, tax codes) are kept | In case you reconnect — same mappings reapply. |
| No data is deleted on either side | Disconnect is non-destructive. |
When to disconnect
- Migration — moving to a different QBO file or accountant.
- Troubleshooting — sync errors that need a fresh handshake.
- Pausing during cleanup — your accountant is reorganizing QBO and you don't want sync churn during the work.
Reconnecting
If you disconnect and want to reconnect later:
- Settings → QuickBooks → Connect QuickBooks Online.
- Re-authorize with QBO admin credentials.
- Previous mappings reapply.
- Sync resumes; any events that queued during the disconnect period start flowing.
When connection drops without you doing it
Occasionally Intuit revokes the OAuth token (e.g. password change on QBO side). The connection status becomes token_expired. The fix is the same as reconnecting: Connect QuickBooks Online → re-authorize.