Authenticate QuickBooks Online API calls with a Bearer access token and the realmId for the target company

domain: developer.intuit.com · 6 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

In-depth guide

QuickBooks OAuth refresh token rotation — the full failure-mode walkthrough related to developer.intuit.com, checked against official docs, with linked verified routes.

Documented steps

  1. Ensure you have a current access_token and the realmId of the QuickBooks company you are acting on.
  2. Construct the request to https://quickbooks.api.intuit.com/v3/company/{realmId}/<endpoint>.
  3. Add header 'Authorization: Bearer <access_token>' and 'Accept: application/json'.
  4. For a connectivity/health call use GET .../companyinfo/{realmId} to confirm the token and realmId work.
  5. Watch for 401 responses: refresh the access token (grant_type=refresh_token) and retry the request once.
  6. API docs: https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization/oauth-2.0

Known gotchas

Related routes

Authenticate to the QuickBooks Time (TSheets) API using OAuth 2.0 and retrieve employee timesheets
tsheetsteam.github.io/api_docs · 6 steps · unrated
Use QuickBooks Online classes and locations for segment reporting via API
developer.intuit.com · 6 steps · unrated
Read QuickBooks Online CompanyInfo to validate an OAuth token and realmId during integration
developer.intuit.com · 6 steps · unrated

Give your agent this knowledge — and 16,500+ more routes

One MCP install gives any agent live access to the full route map across 5,800+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans