--- title: "DIY Developer Guide: Building Custom Integrations for…" url: https://apiworx.com/connectors/quickbooks-online description: "Step-by-step guide for developers building custom QuickBooks Online integrations. Covers OAuth 2.0, REST APIs, webhooks, and common sync patterns for orders…" lang: en --- Commerce operations automation · Connect · Automate · Orchestrate · Flat-fee pricing Developer Guides May 30, 2024 1 min read # 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. Share Share on X: https://twitter.com/intent/tweet?text=DIY%20Developer%20Guide%3A%20Building%20Custom%20Integrations%20for%20QuickBooks&url=https%3A%2F%2Fapiworx.com%2Fblog%2Fdiy-developer-guide-building-custom-integrations-for-quickbooks Share on LinkedIn: https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fapiworx.com%2Fblog%2Fdiy-developer-guide-building-custom-integrations-for-quickbooks Share on Facebook: https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fapiworx.com%2Fblog%2Fdiy-developer-guide-building-custom-integrations-for-quickbooks Ask AI Open this article in ChatGPT: https://chatgpt.com/?q=Analyze%20this%20article%20from%20APIWORX%20and%20summarize%20the%20key%20takeaways%3A%20DIY%20Developer%20Guide%3A%20Building%20Custom%20Integrations%20for%20QuickBooks%20https%3A%2F%2Fapiworx.com%2Fblog%2Fdiy-developer-guide-building-custom-integrations-for-quickbooks Open this article in Perplexity: https://www.perplexity.ai/search?q=Analyze%20this%20article%20from%20APIWORX%3A%20DIY%20Developer%20Guide%3A%20Building%20Custom%20Integrations%20for%20QuickBooks%20https%3A%2F%2Fapiworx.com%2Fblog%2Fdiy-developer-guide-building-custom-integrations-for-quickbooks Open this article in Claude: https://claude.ai/new?q=Analyze%20this%20article%20from%20APIWORX%20and%20extract%20the%20main%20ideas%3A%20DIY%20Developer%20Guide%3A%20Building%20Custom%20Integrations%20for%20QuickBooks%20https%3A%2F%2Fapiworx.com%2Fblog%2Fdiy-developer-guide-building-custom-integrations-for-quickbooks Open this article in Gemini: https://gemini.google.com/app?q=Analyze%20this%20article%20from%20APIWORX%20and%20summarize%20it%3A%20DIY%20Developer%20Guide%3A%20Building%20Custom%20Integrations%20for%20QuickBooks%20https%3A%2F%2Fapiworx.com%2Fblog%2Fdiy-developer-guide-building-custom-integrations-for-quickbooks Image: DIY Developer Guide: Building Custom Integrations for QuickBooks — Developer Guides guide by APIWORX (https://apiworx.com/assets/category-integration-iVxlgWBu.jpg) ## 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 production-tested 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. Talk to an expert (https://apiworx.com/free-assessment) Previous DIY Developer Guide: Building Custom Integrations for BlackLine: https://apiworx.com/blog/diy-developer-guide-building-custom-integrations-for-blackline Next DIY Developer Guide: Building Custom Integrations for Brightpearl: https://apiworx.com/blog/diy-developer-guide-building-custom-integrations-for-brightpearl ## Related Articles ### DIY Developer Guide: Building Custom Integrations for SAP Business ByDesign June 20, 2024 https://apiworx.com/blog/diy-developer-guide-building-custom-integrations-for-sap-business-bydesign ### DIY Developer Guide: Building Custom Integrations for BlackLine June 15, 2024 https://apiworx.com/blog/diy-developer-guide-building-custom-integrations-for-blackline ### DIY Developer Guide: Building Custom Integrations for Brightpearl May 25, 2024 https://apiworx.com/blog/diy-developer-guide-building-custom-integrations-for-brightpearl ## See the platform behind trustworthy operations Tell us about your systems and challenges — our team will build a tailored automation plan within 24 hours. ## Structured data ```json [ { "@context": "https://schema.org", "@graph": [ { "@type": "WebPage", "name": "DIY Developer Guide: Building Custom Integrations for QuickBooks", "description": "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.", "url": "https://apiworx.com/connectors/quickbooks-online", "isPartOf": { "@id": "https://apiworx.com/#website" }, "breadcrumb": { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://apiworx.com/" }, { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://apiworx.com/blog" }, { "@type": "ListItem", "position": 3, "name": "DIY Developer Guide: Building Custom Integrations for QuickBooks" } ] } }, { "@type": "Article", "headline": "DIY Developer Guide: Building Custom Integrations for QuickBooks", "description": "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.", "image": "/assets/category-integration-iVxlgWBu.jpg", "datePublished": "2024-05-30", "dateModified": "2024-05-30", "author": { "@id": "https://apiworx.com/#organization" }, "publisher": { "@id": "https://apiworx.com/#organization" }, "mainEntityOfPage": "https://apiworx.com/blog/diy-developer-guide-building-custom-integrations-for-quickbooks" } ] }, { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://apiworx.com/#organization", "name": "APIWORX", "alternateName": [ "APIWorks", "Apiworx" ], "url": "https://apiworx.com/", "logo": { "@type": "ImageObject", "@id": "https://apiworx.com/#logo", "url": "https://apiworx.com/og-image.png", "caption": "APIWORX" }, "image": { "@id": "https://apiworx.com/#logo" }, "description": "APIWORX is a commerce operations automation platform that connects ERP, ecommerce, marketplaces, EDI, fulfillment, suppliers, and financial systems and automates the workflows running between them.", "foundingDate": "2018", "sameAs": [ "https://www.linkedin.com/company/apiworx", "https://x.com/apiworx", "https://www.facebook.com/apiworx", "https://www.instagram.com/apiworx" ], "address": [ { "@type": "PostalAddress", "streetAddress": "1401 Lavaca Street Suite 241", "addressLocality": "Austin", "addressRegion": "TX", "postalCode": "78701", "addressCountry": "US" }, { "@type": "PostalAddress", "addressLocality": "Chennai", "addressCountry": "IN" }, { "@type": "PostalAddress", "addressLocality": "Manila", "addressCountry": "PH" }, { "@type": "PostalAddress", "addressLocality": "Buenos Aires", "addressCountry": "AR" } ] }, { "@type": "WebSite", "@id": "https://apiworx.com/#website", "name": "APIWORX", "alternateName": [ "APIWorks", "Apiworx" ], "url": "https://apiworx.com/", "inLanguage": "en-US", "description": "APIWORX is a commerce operations automation platform: it connects ERP, ecommerce, marketplaces, EDI, fulfillment, suppliers, and finance, and automates the business processes running between them.", "publisher": { "@id": "https://apiworx.com/#organization" }, "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://apiworx.com/connectors?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@type": "SoftwareApplication", "@id": "https://apiworx.com/#software", "name": "APIWORX", "operatingSystem": "Web", "applicationCategory": "BusinessApplication", "description": "Commerce operations automation platform — prebuilt connectivity across ERP, ecommerce, marketplaces, EDI, and fulfillment, with proven commerce workflows operated by an expert team. Flat-fee pricing.", "url": "https://apiworx.com/", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" }, "publisher": { "@id": "https://apiworx.com/#organization" } } ] }, { "@context": "https://schema.org/", "@type": "SoftwareApplication", "applicationCategory": "BusinessApplication", "name": "APIWORX", "image": "https://sourceforge.net/s/apiworx/icon", "description": "SourceForge Software Rating", "aggregateRating": { "@type": "AggregateRating", "ratingValue": "5", "bestRating": "5", "ratingCount": "1" } } ] ```