---
schema_version: "1"
id: 88edd38eb7a80fd286c75bd8073301c01f0cb549bfe56a8bc3a77f2e54bdf6db
title: Upgrading and Migrating Quickbooks Connector to Version 2.0
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/quickbooks-online-connector/latest/quickbooks-connector-upgrade-migrate.md
canonical_url: https://docs.mulesoft.com/quickbooks-online-connector/latest/quickbooks-connector-upgrade-migrate
source_site: docs.mulesoft.com
content_type: documentation
content_hash: cbfef2e2dbece2664bbb1d4b0962d02c6e14ed867db40a49dd65aadf02cd7fc5
description: MuleSoft Documentation Site
release: "2.0"
latest: true
---
---
product: QuickBooks Online Connector
version: 2.0
is-latest-version: true
---

# Upgrading and Migrating Quickbooks Connector to Version 2.0

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Upgrade Anypoint Connector for Quickbooks (Quickbooks Connector) to version 2.x.

## Supported Upgrade Paths

<table><colgroup><col> <col></colgroup><thead><tr><th>From Version</th><th>To Version</th></tr></thead><tbody><tr><td><div><div><p>1.x</p></div></div></td><td><div><div><p>2.x</p></div></div></td></tr></tbody></table>

## Changes in This Release

This release contains the following changes:

- Made the following changes to some operations:

  - [Changed operation names](#changed_operations)

  - The **Get query** operation now makes an HTTP GET request instead of an HTTP POST request to the
    `/query` endpoint

  - The **Get invoice by invoice id** operation now makes an HTTP GET request instead of an HTTP
    POST request to the `/invoice/{invoiceId}` endpoint

  - The **Upload** operation now has the **File\_content\_0-Body** parameter, the
    **File\_content\_0-Filename** parameter, and the **File\_metadata\_0-Body** parameter

  - Removed the **Content type** parameter from all operations

  - Removed the **Accept** parameter from all operations

  - Added the **Body** parameter to some operations

- [Added sources](#new_sources)

## Changed Operations

The following table shows changes to operation names:

<table><colgroup><col> <col></colgroup><thead><tr><th>Quickbooks 1.x Operation</th><th>Changes in Quickbooks 2.0</th></tr></thead><tbody><tr><td><p><strong>Account Post2</strong></p></td><td><div><div><p>Operation is now called <strong>Create account</strong>.</p></div></div></td></tr><tr><td><p><strong>Account Update</strong></p></td><td><div><div><p>Operation is now called <strong>Create account update</strong>.</p></div></div></td></tr><tr><td><p><strong>Attachable Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create attachable</strong>.</p></div></div></td></tr><tr><td><p><strong>Batch Post</strong></p></td><td><div><div><p>Operation is now called <strong>Create batch</strong>.</p></div></div></td></tr><tr><td><p><strong>Bill Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create bill</strong>.</p></div></div></td></tr><tr><td><p><strong>Billpayment Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create billpayment</strong>.</p></div></div></td></tr><tr><td><p><strong>Class Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create class</strong>.</p></div></div></td></tr><tr><td><p><strong>Creditmemo Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create creditmemo</strong>.</p></div></div></td></tr><tr><td><p><strong>Customer Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create customer</strong>.</p></div></div></td></tr><tr><td><p><strong>Department Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create department</strong>.</p></div></div></td></tr><tr><td><p><strong>Deposit Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create deposit</strong>.</p></div></div></td></tr><tr><td><p><strong>Employee Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create employee</strong>.</p></div></div></td></tr><tr><td><p><strong>Estimate Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create estimate</strong>.</p></div></div></td></tr><tr><td><p><strong>Invoice Post4</strong></p></td><td><div><div><p>Operation is now called <strong>Create invoice</strong>.</p></div></div></td></tr><tr><td><p><strong>Item Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create item</strong>.</p></div></div></td></tr><tr><td><p><strong>Journalentry Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create journalentry</strong>.</p></div></div></td></tr><tr><td><p><strong>Payment Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create payment</strong>.</p></div></div></td></tr><tr><td><p><strong>Paymentmethod Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create paymentmethod</strong>.</p></div></div></td></tr><tr><td><p><strong>Preferences Post</strong></p></td><td><div><div><p>Operation is now called <strong>Create preferences</strong>.</p></div></div></td></tr><tr><td><p><strong>Purchase Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create purchase</strong>.</p></div></div></td></tr><tr><td><p><strong>Purchaseorder Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create purchaseorder</strong>.</p></div></div></td></tr><tr><td><p><strong>Query Post32</strong></p></td><td><div><div><p>Operation is now called <strong>Get query</strong>.</p></div></div></td></tr><tr><td><p><strong>Refundreceipt Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create refundreceipt</strong>.</p></div></div></td></tr><tr><td><p><strong>Salesreceipt Post4</strong></p></td><td><div><div><p>Operation is now called <strong>Create salesreceipt</strong>.</p></div></div></td></tr><tr><td><p><strong>Taxagency Post</strong></p></td><td><div><div><p>Operation is now called <strong>Create taxagency</strong>.</p></div></div></td></tr><tr><td><p><strong>Taxservice Taxcode Post</strong></p></td><td><div><div><p>Operation is now called <strong>Create taxservice taxcode</strong>.</p></div></div></td></tr><tr><td><p><strong>Term Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create term</strong>.</p></div></div></td></tr><tr><td><p><strong>Timeactivity Post4</strong></p></td><td><div><div><p>Operation is now called <strong>Create timeactivity</strong>.</p></div></div></td></tr><tr><td><p><strong>Transfer Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create transfer</strong>.</p></div></div></td></tr><tr><td><p><strong>Upload Post</strong></p></td><td><div><div><p>Operation is now called <strong>Create upload</strong>.</p></div></div></td></tr><tr><td><p><strong>Vendor Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create vendor</strong>.</p></div></div></td></tr><tr><td><p><strong>Vendorcredit Post3</strong></p></td><td><div><div><p>Operation is now called <strong>Create vendorcredit</strong>.</p></div></div></td></tr><tr><td><p><strong>Account Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get account by account id</strong>.</p></div></div></td></tr><tr><td><p><strong>Attachable Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get attachable by attachable id</strong>.</p></div></div></td></tr><tr><td><p><strong>Bill Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get bill by bill id</strong>.</p></div></div></td></tr><tr><td><p><strong>Billpayment Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get billpayment by billpayment id</strong>.</p></div></div></td></tr><tr><td><p><strong>Cdc Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get cdc</strong>.</p></div></div></td></tr><tr><td><p><strong>Class Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get class by class id</strong>.</p></div></div></td></tr><tr><td><p><strong>Companyinfo By Companyid Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get companyinfo by company id</strong>.</p></div></div></td></tr><tr><td><p><strong>Creditmemo Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get creditmemo by creditmemo id</strong>.</p></div></div></td></tr><tr><td><p><strong>Customer Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get customer by customer id</strong>.</p></div></div></td></tr><tr><td><p><strong>Department Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get department by department id</strong>.</p></div></div></td></tr><tr><td><p><strong>Deposit Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get deposit by deposit id</strong>.</p></div></div></td></tr><tr><td><p><strong>Employee Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get employee by employee id</strong>.</p></div></div></td></tr><tr><td><p><strong>Estimate Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get estimate by estimate id</strong>.</p></div></div></td></tr><tr><td><p><strong>Exchangerate Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get exchangerate</strong>.</p></div></div></td></tr><tr><td><p><strong>Invoice Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get invoice by invoice id</strong>.</p></div></div></td></tr><tr><td><p><strong>Item ID Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get item by item id</strong>.</p></div></div></td></tr><tr><td><p><strong>Journalentry Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get journalentry by journalentry id</strong>.</p></div></div></td></tr><tr><td><p><strong>Payment174Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get payment by payment id</strong>.</p></div></div></td></tr><tr><td><p><strong>Paymentmethod Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get paymentmethod by paymentmethod id</strong>.</p></div></div></td></tr><tr><td><p><strong>Preferences Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get preferences</strong>.</p></div></div></td></tr><tr><td><p><strong>Purchase Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get purchase by purchase id</strong>.</p></div></div></td></tr><tr><td><p><strong>Purchaseorder Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get purchaseorder by purchaseorder id</strong>.</p></div></div></td></tr><tr><td><p><strong>Refundreceipt Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get refundreceipt by refundreceipt id</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Account List Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports account list</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Aged Payable Detail Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports aged payable detail</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Aged Payables Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports aged payables</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Aged Receivable Detail Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports aged receivable detail</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Aged Receivables Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports aged receivables</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Balance Sheet Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports balance sheet</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Cash Flow Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports cash flow</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Class Sales Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports class sales</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Customer Balance Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports customer balance</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Customer Balance Detail Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports customer balance detail</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Customer Income Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports customer income</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Customer Sales Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports customer sales</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Department Sales Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports department sales</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports General Ledger Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports general ledger</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Inventory Valuation Summary Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports inventory valuation summary</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Item Sales Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports item sales</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Profit And Loss Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports profit and loss</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Profit And Loss Detail Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports profit and loss detail</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Transaction List Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports transaction list</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Trial Balance Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports trial balance</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Vendor Balance Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports vendor balance</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Vendor Balance Detail Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports vendor balance detail</strong>.</p></div></div></td></tr><tr><td><p><strong>Reports Vendor Expenses Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get reports vendor expenses</strong>.</p></div></div></td></tr><tr><td><p><strong>Salesreceipt Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get salesreceipt by salesreceipt id</strong>.</p></div></div></td></tr><tr><td><p><strong>Taxagency Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get taxagency by taxagency id</strong>.</p></div></div></td></tr><tr><td><p><strong>Taxcode Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get taxcode by taxcode id</strong>.</p></div></div></td></tr><tr><td><p><strong>Taxrate Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get taxrate by taxrate id</strong>.</p></div></div></td></tr><tr><td><p><strong>Term Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get term by term id</strong>.</p></div></div></td></tr><tr><td><p><strong>Transfer Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get transfer by transfer id</strong>.</p></div></div></td></tr><tr><td><p><strong>Vendor Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get vendor by vendor id</strong>.</p></div></div></td></tr><tr><td><p><strong>Vendorcredit Get</strong></p></td><td><div><div><p>Operation is now called <strong>Get vendorcredit by vendorcredit id</strong>.</p></div></div></td></tr></tbody></table>

## New Sources

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Quickbooks Source</th><th>Description</th><th>Parameters</th></tr></thead><tbody><tr><td><p>On new customer</p></td><td><div><div><p>Triggers an event for every new customer.</p></div></div></td><td><div><div><ul><li><p>Configuration</p></li><li><p>Created time</p></li><li><p>Config Ref</p></li><li><p>Primary Node Only</p></li><li><p>Scheduling Strategy</p></li><li><p>Streaming Strategy</p></li><li><p>Redelivery Policy</p></li><li><p>Reconnection Strategy</p></li></ul></div></div></td></tr><tr><td><p>On new invoice</p></td><td><div><div><p>Triggers an event for every new invoice.</p></div></div></td><td><div><div><ul><li><p>Configuration</p></li><li><p>Created time</p></li><li><p>Config Ref</p></li><li><p>Primary Node Only</p></li><li><p>Scheduling Strategy</p></li><li><p>Streaming Strategy</p></li><li><p>Redelivery Policy</p></li><li><p>Reconnection Strategy</p></li></ul></div></div></td></tr><tr><td><p>On new item</p></td><td><div><div><p>Triggers an event for every new item.</p></div></div></td><td><div><div><ul><li><p>Configuration</p></li><li><p>Created time</p></li><li><p>Config Ref</p></li><li><p>Primary Node Only</p></li><li><p>Scheduling Strategy</p></li><li><p>Streaming Strategy</p></li><li><p>Redelivery Policy</p></li><li><p>Reconnection Strategy</p></li></ul></div></div></td></tr><tr><td><p>On updated customer</p></td><td><div><div><p>Triggers an event for every updated customer.</p></div></div></td><td><div><div><ul><li><p>Configuration</p></li><li><p>Last Updated Time</p></li><li><p>Config Ref</p></li><li><p>Primary Node Only</p></li><li><p>Scheduling Strategy</p></li><li><p>Streaming Strategy</p></li><li><p>Redelivery Policy</p></li><li><p>Reconnection Strategy</p></li></ul></div></div></td></tr><tr><td><p>On updated invoice</p></td><td><div><div><p>Triggers an event for every updated invoice.</p></div></div></td><td><div><div><ul><li><p>Configuration</p></li><li><p>Last Updated Time</p></li><li><p>Config Ref</p></li><li><p>Primary Node Only</p></li><li><p>Scheduling Strategy</p></li><li><p>Streaming Strategy</p></li><li><p>Redelivery Policy</p></li><li><p>Reconnection Strategy</p></li></ul></div></div></td></tr><tr><td><p>On updated item</p></td><td><div><div><p>Triggers an event for every updated item.</p></div></div></td><td><div><div><ul><li><p>Configuration</p></li><li><p>Last Updated Time</p></li><li><p>Config Ref</p></li><li><p>Primary Node Only</p></li><li><p>Scheduling Strategy</p></li><li><p>Streaming Strategy</p></li><li><p>Redelivery Policy</p></li><li><p>Reconnection Strategy</p></li></ul></div></div></td></tr></tbody></table>

## Upgrade Prerequisites

Before you perform the upgrade, you must:

1.  Create a backup of your files, data, and configuration in case you need to restore to the
    previous version.

2.  Install Quickbooks Connector v2.x to replace the Quickbooks operations that were previously
    included in Quickbooks Connector v1.x.

## Upgrade Steps

Follow these steps to perform the upgrade:

1.  In Anypoint Studio, create a Mule project.

2.  In **Mule Palette**, click **Search in Exchange**.

3.  In **Add Dependencies to Project**, enter `quickbooks` in the search field.

4.  In **Available modules**, select **Quickbooks Connector \* and click \*Add**.

5.  Click **Finish**.

6.  Verify that the `quickbooks-connector` dependency version is `2.x.x` in the `pom.xml` file in
    the Mule project.

Studio upgrades the connector automatically.

### Verify the Upgrade

After you install the latest version of the connector, follow these steps to verify the upgrade:

1.  In Studio, verify that there are no errors in the **Problems** or **Console** views.

2.  Verify that there are no problems in the project `pom.xml` file.

3.  Test the connection to verify that the operations work.

## Troubleshooting

If there are problems with caching the parameters and caching the metadata, try restarting Studio.

### Revert the Upgrade

If it is necessary to revert to the previous version of Quickbooks Connector, change the
`quickbooks-connector` dependency version in the project’s `pom.xml` file to the previous version.

You must update the project’s `pom.xml` file in Anypoint Studio.

## See Also

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [Salesforce Help](https://help.salesforce.com)