> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hotglue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# QuickBooks

# Connector Details

| Name           | Value                                                                                                                                                                                                                                                                                                             |
| :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Platform       | [QuickBooks](https://quickbooks.intuit.com)                                                                                                                                                                                                                                                                       |
| Auth Type      | OAuth                                                                                                                                                                                                                                                                                                             |
| Direction      | Bidirectional                                                                                                                                                                                                                                                                                                     |
| Tap Repo       | [https://github.com/hotgluexyz/tap-quickbooks](https://github.com/hotgluexyz/tap-quickbooks)                                                                                                                                                                                                                      |
| Target Repo    | [https://github.com/hotgluexyz/target-quickbooks-v2](https://github.com/hotgluexyz/target-quickbooks-v2)                                                                                                                                                                                                          |
| Tap Metrics    | <p>Usage: <Tooltip tip="high"><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#fff" size="14px" /></Tooltip></p>      |
| Target Metrics | <p>Usage: <Tooltip tip="low"><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /></Tooltip></p> |
| Unified Schema | <Tooltip tip="Supported tables: Accounts, Bills, Customers, Items, Vendors, Invoices, GeneralLedgerReport, ProfitAndLossReport, Classes, CustomerTypes, PaymentMethods, PaymentTerms, Departments, TaxRates">Supported in [Accounting Unified Schema](https://hotglue.com/docs/unified).</Tooltip>                |

# Credentials Setup

Follow the steps below to get the credentials you need to use the QuickBooks connector.

To create a QuickBooks OAuth app, you will need to register for a [free developer account](https://developer.intuit.com/app/developer/qbdesktop/docs/get-started/create-an-intuit-developer-account) on the [Intuit Developer Portal](https://developer.intuit.com/app/developer/homepage).

Once you have registered for an Intuit Developer account, you should be able to access the [Developer Dashboard](https://developer.intuit.com/app/developer/dashboard) which should look something like below:

![](https://files.readme.io/0a96285-developer.intuit.com_app_developer_dashboard.png)

From here, you can create an OAuth app by selecting Create an app. Select QuickBooks Online and Payments as the platform you want to develop for, as pictured below:

![](https://files.readme.io/ca84494-developer.intuit.com_app_developer_dashboard_1.png)

You will then need to provide an app name, scope, and select the teamt o access the app. hotglue integrations generally **do not** deal with QuickBooks Payments, so you can just select the `com.intuit.quickbooks.accounting` scope as pictured below:

![](https://files.readme.io/d139931-developer.intuit.com_app_developer_dashboard_2.png)

Once done, select **Create app**. This will take you to the App settings page, where you can configure two separate sets of credentials:

* **Development Settings** gives you credentials / settings for configuring an OAuth app to access QuickBooks Online Sandbox accounts. This is only for testing purposes.
* **Production Settings** gives you credentials / settngs for configuring an OAuth app to access QuickBooks Online Production accounts.

For this example, I will walk through the **Development Settings**, as the process is the same for both. Click on **Keys & credentials**

![](https://files.readme.io/b1718b9-developer.intuit.com_app_developer_dashboard_3.png)

You should then see a screen similar to below, where you can a **Redirect URI**:

![](https://files.readme.io/dcc66eb-developer.intuit.com_app_developer_dashboard_4.png)

From this screen, add `<https://hotglue.xyz/callback`> as a valid redirect URI. If you do not do this step, hotglue will not be able to make OAuth connections on your behalf. Once done, click **Save**

![](https://files.readme.io/bc800d6-Screen_Shot_2022-08-23_at_4.55.18_PM.png)

Now you can insert the client id and client secret pair from the **Keys** section into your hotglue QuickBooks source settings.

# Tap Changelog

<Accordion title="Tap Changelog">
  | Version                                                                                                                            | Notes                                                        |
  | :--------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------- |
  | [v1.6.4](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.6.4)                                                         |                                                              |
  | [v1.6.3](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.6.3)                                                         |                                                              |
  | [v1.6.2](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.6.2)                                                         |                                                              |
  | [v1.6.1](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.6.1)                                                         |                                                              |
  | [v1.6.0](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.6.0)                                                         |                                                              |
  | [v1.5.17](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.17)                                                       |                                                              |
  | [v1.5.16](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.16)                                                       | fixes                                                        |
  | [v1.5.15](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.15)                                                       | fixes                                                        |
  | [v1.5.14](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.14)                                                       | bug fixes                                                    |
  | [v1.5.13](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.13)                                                       | bug fixes                                                    |
  | [v1.5.12](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.12)                                                       | fixes                                                        |
  | [v1.5.11](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.11)                                                       |                                                              |
  | [v1.5.10](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.10)                                                       |                                                              |
  | [v1.5.9](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.9)                                                         |                                                              |
  | [v1.5.8](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.8)                                                         |                                                              |
  | [v1.5.7](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.7)                                                         |                                                              |
  | [v1.5.6](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.6)                                                         |                                                              |
  | [v1.5.5](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.5)                                                         |                                                              |
  | [v1.5.4](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.4)                                                         |                                                              |
  | [v1.5.3](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.3)                                                         |                                                              |
  | [v1.5.2](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.2)                                                         |                                                              |
  | [v1.5.1](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.1)                                                         |                                                              |
  | [v1.5.0](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.5.0)                                                         |                                                              |
  | [v1.4.53](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.53)                                                       |                                                              |
  | [v1.4.52](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.52)                                                       |                                                              |
  | [v1.4.49](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.49)                                                       |                                                              |
  | [v1.4.48](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.48)                                                       |                                                              |
  | [v1.4.47](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.47)                                                       |                                                              |
  | [v1.4.46](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.46)                                                       |                                                              |
  | [v1.4.45](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.45)                                                       |                                                              |
  | [v1.4.44](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.44)                                                       |                                                              |
  | [v1.4.43](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.43)                                                       |                                                              |
  | [v1.4.42](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.42)                                                       |                                                              |
  | [v1.4.41](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.41)                                                       |                                                              |
  | [v1.4.39](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.39)                                                       |                                                              |
  | [v1.4.38](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.38)                                                       |                                                              |
  | [v1.4.37 - Include description on invoice and credit line item](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.37) | Include description on invoice and credit line item          |
  | [v1.4.36 - Add Support for SalesReceipt](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.36)                        | Adds support for `SalesReceipt` entity                       |
  | [v1.4.35 - P\&L Stream Fixes](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.35)                                   | Fixed bug with P\&L stream when malformed data was passed in |
  | [v1.4.34](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.34)                                                       | Hot fix on `v1.4.33` for normal streams                      |
  | [v1.4.33](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.33)                                                       | Enable full sync of P\&L report when state is not passed     |
  | [v1.4.32 - P\&L Report fixes](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.32)                                   | - Avoid returning if current period has no data in P\&L      |
  | [v1.4.31 - Add support for Qty and UnitPrice in invoice line](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.31)   | Add support for Qty and UnitPrice in invoice line            |
  | [v1.4.30 - Support for Purchases and TimeActivity](https://github.com/hotgluexyz/tap-quickbooks/releases/tag/v1.4.30)              | Added two more QBO entities to discoverable list.            |
</Accordion>
