DIY Developer Guide: Building Custom Integrations for QuickBooks

Step-by-step guide for developers building custom QuickBooks Online integrations. Covers OAuth 2.0, REST APIs, webhooks, and common sync patterns for orders, invoices, and inventory.

Overview

QuickBooks Online (QBO) is the most widely used small-to-mid-market accounting platform. Its REST API enables developers to build integrations for invoicing, payments, inventory, and financial reporting. This guide covers practical patterns for building reliable QBO integrations.

Authentication with OAuth 2.0

QuickBooks uses OAuth 2.0 for all API access:

1. Register your app on the Intuit Developer Portal
2. Implement the authorization code flow to get access and refresh tokens
3. Store tokens securely — access tokens expire in 1 hour, refresh tokens in 100 days
4. Implement automatic token refresh before expiration

Key API Endpoints

• Invoices: POST /v3/company/{realmId}/invoice
• Payments: POST /v3/company/{realmId}/payment
• Items (Products): POST /v3/company/{realmId}/item
• Customers: POST /v3/company/{realmId}/customer
• Purchase Orders: POST /v3/company/{realmId}/purchaseorder

Common Integration Patterns

Order to Invoice Sync

1. Receive order data from your ecommerce platform
2. Check if the customer exists in QBO — create if not
3. Map order line items to QBO items
4. Create the invoice with proper tax and discount handling
5. Record payment when order is paid

Inventory Sync

1. Query QBO item quantities on hand
2. Compare with ecommerce inventory levels
3. Adjust quantities in the lagging system
4. Handle multi-location inventory if applicable

Webhook Integration

QBO supports webhooks for real-time notifications:

• Subscribe to entity change events (Invoice, Payment, Customer, etc.)
• Validate webhook signatures for security
• Process events asynchronously to avoid timeout issues
• Implement idempotent handlers to manage duplicate deliveries

Rate Limiting

QBO enforces rate limits:

• 500 requests per minute per realm
• 10 concurrent requests per realm
• Implement queuing and throttling for high-volume scenarios

When to Use a Managed Platform

QuickBooks integrations seem simple but get complex fast — multi-currency, tax handling, class tracking, and error recovery all add layers of difficulty. APIWORX handles these complexities with pre-built QuickBooks connectors, so your team can focus on business operations instead of API plumbing.

Don't want to build it yourself? We'll do it for you.

This guide shows how to build it manually. APIWORX automates all of this in 2–4 weeks with zero developer time required.

Book a Free Assessment