Skip to main content

​
Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

​
Pre-built tooling

ToolsStatus
Pre-built authorization (OAuth)✅
Credentials auto-refresh✅
Pre-built authorization UI✅
Custom authorization UI✅
End-user authorization guide✅
Expired credentials detection✅
ToolsStatus
Pre-built integrations✅
API unification✅
2-way sync✅
Webhooks from Nango on data modifications✅
Real-time webhooks from 3rd-party API🚫 (time to contribute: <48h)
Proxy requests✅
ToolsStatus
HTTP request logging✅
End-to-type type safety✅
Data runtime validation✅
OpenTelemetry export✅
Slack alerts on errors✅
Integration status API✅
ToolsStatus
Create or customize use-cases✅
Pre-configured pagination🚫 (time to contribute: <48h)
Pre-configured rate-limit handling🚫 (time to contribute: <48h)
Per-customer configurations✅

​
Accounts

Function nameDescriptionTypeSource code
create-accountCreates a single account in QuickBooks.Action🔗 Github
update-accountUpdates a single account in QuickBooks.Action🔗 Github
accountsFetches all accounts in QuickBooks. Handles both active and archived accounts, saving or deleting them based on their status.Sync🔗 Github

​
Bill Payments

Function nameDescriptionTypeSource code
bill-paymentsFetches all QuickBooks bill paymentsSync🔗 Github

​
Bills

Function nameDescriptionTypeSource code
create-billCreates a single bill in QuickBooks.Action🔗 Github
billsFetches all QuickBooks billsSync🔗 Github

​
Credit Memos

Function nameDescriptionTypeSource code
create-credit-memoCreates a single credit memo in QuickBooks.Action🔗 Github
update-credit-memoUpdates a single credit memo in QuickBooks.Action🔗 Github
credit-memosFetches all QuickBooks credit memosSync🔗 Github

​
Customers

Function nameDescriptionTypeSource code
create-customerCreates a single customer in QuickBooks.Action🔗 Github
update-customerUpdate a single customer in QuickBooks.Action🔗 Github
customersFetches all QuickBooks customers. Handles both active and archived customers, saving or deleting them based on their status.Sync🔗 Github

​
Deposits

Function nameDescriptionTypeSource code
depositsFetches all QuickBooks depositsSync🔗 Github

​
Invoices

Function nameDescriptionTypeSource code
create-invoiceCreates a single invoice in QuickBooks.Action🔗 Github
update-invoiceUpdates a single invoice in QuickBooks.Action🔗 Github
invoicesFetches all invoices in QuickBooks. Handles both active and voided invoices, saving or deleting them based on their status.Sync🔗 Github

​
Items

Function nameDescriptionTypeSource code
create-itemCreates a single item in QuickBooks.Action🔗 Github
update-itemUpdate a single item in QuickBooks.Action🔗 Github
itemsFetches all items in QuickBooks. Handles both active and archived items, saving or deleting them based on their status.Sync🔗 Github

​
Journal Entries

Function nameDescriptionTypeSource code
create-journal-entryCreates a single journal entry in QuickBooks.Action🔗 Github
update-journal-entryUpdate a single journal entry in QuickBooks.Action🔗 Github
journal-entriesFetch all journal entries in QuickBooksSync🔗 Github

​
Payments

Function nameDescriptionTypeSource code
create-paymentCreates a single payment in QuickBooks.Action🔗 Github
paymentsFetches all payments in QuickBooks. Handles both active and voided payments, saving or deleting them based on their status.Sync🔗 Github

​
Purchase Orders

Function nameDescriptionTypeSource code
create-purchase-orderCreates a single purchase order in QuickBooks.Action🔗 Github

​
Purchases

Function nameDescriptionTypeSource code
purchasesFetches all QuickBooks purchasesSync🔗 Github

​
Transfers

Function nameDescriptionTypeSource code
transfersFetches all QuickBooks transfersSync🔗 Github

​
Access requirements

Pre-RequisitesStatusComment
Paid dev account✅ Not requiredFree, self-signup for an Intuit Developer account.
Paid test account✅ Not requiredDevelopment/sandbox accounts can be created for free from your Developer account.
Partnership✅ Not required
App review✅ Not requiredOnly required for apps published to the Intuit App Store.
Security audit✅ Not required

​
Setup guide

1

Create an Intuit Developer account

Go to Intuit Developer signup page and create a free account.
2

Create a new app in your Developer account

  1. From your Developer Dashboard, navigate to My Hub > App Dashboard, then click on the Add button.
  2. Select QuickBooks Online and Payments, click Next and provide a name for your app.
  3. Click Next to proceed with adding permissions to your app.
  4. Once you have added permissions, click Done and confirm the permissions you selected. Your application will be created.
3

Configure OAuth settings

In the app you just created:
  1. Navigate to the Settings page, then go to the Redirect URIs tab and add the following URL: https://api.nango.dev/oauth/callback.
  2. Save your changes.
4

Obtain API credentials

  1. Still in your created app, navigate to Keys and credentials page and toggle the Show credentials button to locate your app’s credentials.
  2. Copy the Client ID and Client Secret.
  3. You will need these credentials when configuring your integration in Nango.
5

Create a development/sandbox account for testing

If you don’t have a QuickBooks account already:
  1. From your Developer Dashboard, go to My Hub > Sandbox, then click Add to create a new Sandbox company.
  2. Follow the prompts to create a test company.
  3. Note the Company ID/Realm ID as you’ll need it for API requests.
6

Next

Follow the Quickstart.
Need help getting started? Get help in the community.
TopicLinks
GeneralWebsite
Create a Developer account
Create a sandbox company
DeveloperAPI documentation
Developer dashboard
Authentication documentation
OAuth 2.0 guide
How to register an application
List of OAuth scopes
Rate limits
Contribute useful links by editing this page

​
Common Scopes

ScopeDescription
com.intuit.quickbooks.accountingAccess to QuickBooks accounting data
com.intuit.quickbooks.paymentAccess to QuickBooks payments data
profileAccess to user profile information
emailAccess to user email address
phoneAccess to user phone number
addressAccess to user address
openidRequired for OpenID Connect authentication

​
API gotchas

  • QuickBooks requires a company ID/realmId for each API request. To obtain this when creating a new connection on Nango, go to Settings and select Your Account and Settings. On the Your Account page, your Company ID (found under the Billing & Subscription tab) will be displayed at the top. Nango can automatically retrieve this for you, or you can manually override it by specifying the realmId when creating a new connection.
  • You can use getConnection in your integration function to retrieve it, or when you fetch the Connection credentials with the REST API or SDK
  • For sandbox testing, use the quickbooks-sandbox integration in Nango instead of the regular quickbooks integration.
  • QuickBooks access tokens expire after 1 hour, but Nango automatically handles token refresh for you.
Contribute API gotchas by editing this page