Skip to main content

​
What’s Supported

QuickBooks is available as two connectors:
EnvironmentProvider nameBase URL
Productionquickbookshttps://quickbooks.api.intuit.com
SandboxquickbooksSandboxhttps://sandbox-quickbooks.api.intuit.com
Both connectors share the same supported actions, objects, and OAuth2 configuration — the only difference is the base URL used for API calls. Use the sandbox connector during development and testing with your QuickBooks sandbox company, and switch to the production connector when going live.

​
Supported actions

  • Read Actions, including full historic backfill and incremental reads.
  • Write Actions.
  • Proxy Actions, using the base URL https://quickbooks.api.intuit.com (production) or https://sandbox-quickbooks.api.intuit.com (sandbox).

​
Supported Objects

The QuickBooks connector supports reading from and writing to the following objects: The QuickBooks connector supports reading from the following objects (read-only): The QuickBooks connector supports writing to the following objects (write-only):

​
Example Integration

For example manifest files, visit our samples repo on Github:

​
Before you get started

You’ll need a QuickBooks account and will need to create a QuickBooks app to obtain the necessary OAuth2 credentials.

​
Creating a QuickBooks App

  1. Go to the Intuit Developer Dashboard
  2. Sign in with your Intuit account or create one if needed
  3. Click Create an app
  4. Choose QuickBooks Online Accounting API
  5. Provide your app details:
    • App name: Choose a descriptive name for your app
    • Description: Brief description of your integration
  6. Click Create app
  7. Once created, navigate to the Keys & OAuth tab
  8. Note down your credentials for both environments:
    • Development (Sandbox): Client ID and Client Secret listed under the Development section — use these with the quickbooksSandbox provider.
    • Production: Client ID and Client Secret listed under the Production section — use these with the quickbooks provider.
  9. Under Redirect URIs, add: https://api.withampersand.com/callbacks/v1/oauth
Common scopes include:
  • com.intuit.quickbooks.accounting - Full access to accounting data
  • com.intuit.quickbooks.payment - Access to payment data
For details on scopes, refer to the QuickBooks Scopes guide.

​
Add your QuickBooks app info to Ampersand

  1. Log in to your Ampersand Dashboard.
  2. Select the project where you want to create a QuickBooks integration. Alt text
  3. Select Provider apps.
  4. Select QuickBooks from the Provider list, or QuickBooks Sandbox if you are setting up a development integration.
  5. Enter the previously obtained Client ID in the Client ID field and the Client Secret in the Client Secret field.
  6. Enter the scopes required for your application in Scopes. Alt text
  7. Click Save Changes.

​
Using the connector

To start integrating with Kit:
  • Create a manifest file as shown in the example above.
  • Deploy it using the amp CLI.
  • Embed the InstallIntegration UI component.
  • Start using the connector!
    • If your integration has Proxy Actions, you can start making Proxy API calls.
QuickBooks API returns XML responses by default. To receive JSON responses, make sure to set the Accept header to application/json in your proxy API calls.

​
API documentation