Granting OAuth Access to QuickBooks Online for Third-Party Apps
Connecting a third-party app to QuickBooks Online comes down to one screen: the OAuth consent page. Approve it and the app receives a token it uses in place of your password. We cover what that screen grants, how to approve it, how to revoke it later, and what to check when a connection stops syncing.
The consent screen is the whole agreement
OAuth is an open standard that lets one service act on your behalf without ever seeing your QuickBooks password. When you click Connect in an app’s setup flow, QuickBooks Online shows a consent screen listing every permission the app wants, such as viewing invoices, editing customers, or running reports.
Approving that screen creates a token the app stores and presents on each later API call. Revoke the token and the app’s access ends immediately. That is the entire deal: scoped permissions in exchange for a revocable token, and your password never leaves QuickBooks.
Grant access to an app
- Open QuickBooks Online and click the Settings gear in the upper-right corner.
- Choose Manage Users, or Apps if your version shows that instead. Connections live here, inside QuickBooks, not only inside the app.
- Select the app you want, or pick Find apps to browse the marketplace first.
- Sign in to the app if it prompts you, then read the permission list on the consent screen.
- Click Authorize, Connect, or Allow to finish the flow.
The app then appears in your connected apps list and syncs under the permissions you granted. Step 4 is the one worth slowing down for: the permission list is the complete record of what the app may touch, and reading it now beats auditing later.
Review or revoke a connection
Every active connection sits under the same Settings path, so there is no second menu to learn. Open the gear, choose Manage Users or Apps, and find the app in the connected list. Details or Manage shows the scopes you granted; Disconnect, Remove, or Revoke access stops the app’s calls at once.
Note what revoking does not do: it deletes nothing the app already downloaded. It only blocks further calls, so treat it as an access decision rather than a cleanup.
Why would a connected app stop syncing?
Work through these in order when a connected app goes quiet:
- Confirm the app still sits in your connected apps list. If it has vanished, walk the authorization steps again.
- Check the app’s error log for “invalid token” or “expired consent”; both point to a stale token rather than damaged data.
- Confirm your QuickBooks Online user role covers the requested permissions, such as Administrator or suitable custom access rights.
- Still failing? Disconnect and re-authorize, which generates a fresh token and clears most stale-credential errors.
For problems beyond the authorization itself, our QuickBooks Online troubleshooting guides cover the QuickBooks side of a failing sync.
Confirm the connection before you rely on it
Give the app one small job before it earns a place in daily operations: import a single invoice or pull a short customer list. Success confirms the token, the scopes, and your user role in one pass. From there you can trust the connection for everyday work.