How to Connect QuickBooks Online to an AI Agent
Auth setup
1. Register at developer.intuit.com. 2. Create app for QuickBooks Online. 3. Use OAuth 2.0 Authorization Code flow. 4. Get realmId (company ID) during auth.
Key facts
| Base URL | https://quickbooks.api.intuit.com/v3/ |
|---|
| API version | v3 |
|---|
| Auth | OAuth 2.0. Register app at developer.intuit.com. Use OAuth Playground for testing. |
|---|
| Token URL | https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer |
|---|
| Scopes | com.intuit.quickbooks.accounting |
|---|
| Request body | application/json |
|---|
| Pagination | SQL-like query: STARTPOSITION and MAXRESULTS (e.g., SELECT * FROM Invoice STARTPOSITION 1 MAXRESULTS 100). |
|---|
| Rate limit | 500 req/min per realmId. Concurrent: 10 requests. Throttle at 40% of limit. |
|---|
| Error format | JSON: {"Fault":{"Error":[{"Message":"...","Detail":"...","code":"..."}]}} |
|---|
Key endpoints
| Method | Path | Description |
|---|
POST | /company/{realmId}/invoice | Create invoice |
GET | /company/{realmId}/query?query=SELECT... | Query entities with SQL-like syntax |
POST | /company/{realmId}/payment | Record payment |
GET | /company/{realmId}/reports/ProfitAndLoss | Get P&L report |
Quickstart
GET /v3/company/{realmId}/query?query=SELECT * FROM Invoice WHERE TotalAmt > '100.00'
Authorization: Bearer {access_token}
Accept: application/json
Agent pitfalls & tips
- realmId (company ID) is essential — obtained during OAuth flow.
- Use SQL-like query language for flexible data retrieval.
- Sandbox has pre-populated test data — great for development.
- Minor version header recommended: 'Intuit_tid' for request tracking.
- Webhooks available for real-time notifications on entity changes.
- USD amounts use decimal (123.45), not integer cents.
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-07. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is QuickBooks Online's AEO score?
▼
QuickBooks Online has an AEO score of 0.70 and is rated A (Functional agent integration). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is QuickBooks Online AI-agent-ready?
▼
QuickBooks Online is currently connectable for AI agent use. API access is available but no dedicated MCP server has been published yet. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does QuickBooks Online compare to other Accounting & Finance services?
▼
In the Accounting & Finance category, QuickBooks Online is rated A. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how QuickBooks Online compares.
How can I integrate QuickBooks Online with an AI agent?
▼
The fastest way to integrate QuickBooks Online with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with QuickBooks Online?
▼
OAuth 2.0. Register app at developer.intuit.com. Use OAuth Playground for testing. Setup: 1. Register at developer.intuit.com. 2. Create app for QuickBooks Online. 3. Use OAuth 2.0 Authorization Code flow. 4. Get realmId (company ID) during auth.
What are QuickBooks Online's API rate limits?
▼
500 req/min per realmId. Concurrent: 10 requests. Throttle at 40% of limit.