​
What’s Supported

​
Supported actions

  • Proxy Actions, using the base URL https://quickbooks.api.intuit.com.

​
Example Integration

# amp.yaml
specVersion: 1.0.0
integrations:
  - name: quickbooksIntegration
    displayName: QuickBooks Integration
    provider: quickbooks
    proxy:
      enabled: true
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.

​
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:
    • Client ID
    • Client Secret
  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.
  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.

​
API documentation