---
title: Quickbooks Webhook
slug: quickbooks-webhook
description: Add Quickbooks Webhook listening for your user facing integrations
docTags: 
createdAt: 2023-01-10T06:14:01.000Z
---

Through Pathfix Automation, you can enable user webhook listening for all your user that have connected their Quickbooks account via Pathfix OAuth. 

The following documentation will guide you on how you can setup your Quickbooks account and setup Quickbooks Webhook listening for all your connected users.



### Setup in Pathfix OAuth

Before proceeding, make sure you have setup your Quickbooks integration in [Pathfix OAuth](https://app.pathfix.com/) and have added the Connect button for your users to be able to connect their Quickbooks accounts.

- Configure your Quickbooks integration in Pathfix OAuth
- Add the script tag in your application to allow your users to authenticate their Quickbooks accounts (Detailed documentation for Pathfix OAuth can be [found here](https://docs.pathfix.com/))



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/PkvCRLmodo1mxLZlWP1D3_image.png" size="80" width="1761" height="720" position="center" showCaption="false"}



### Setup in Pathfix Automation

- Create a blank automation by clicking on Design and selecting New Design
- Give your first task a name to save the automation (autosave)



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/iHQC6_46jPnFXftKQorYh_image.png" size="82" width="1755" height="1296" position="center" showCaption="false"}



- Click on the **Test and Publish **tab and click on **Test **to run a test on the automation
- On successful completion, click on **Publish to Live**



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/YfaspJXp2UJE-EzS9Gh0O_image.png" size="86" width="1859" height="863" position="center" showCaption="false"}



- Click on **Endpoints **and copy the endpoint url for use in the Webhook setup
- Live Endpoint is for Live environments and Dev endpoint is for testing/development



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/9_sZE6qJjuoEJ-rObZY9w_image.png" size="48" width="778" height="1019" position="center" showCaption="false"}



- Click on **Webhooks **from the top navigation and click on **Create New**
- Select Quickbooks from the list of provider webhooks 
- Paste the endpoint URL copied from the automation into the **Callback URL** section

 

::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/CEZ0xc1vLblRq5oToiDWV_image.png" size="74" width="1396" height="1091" position="center" showCaption="false"}



- Click on the **Pathfix OAuth** tab and enter your Pathfix OAuth [Public Key and Private Key](https://docs.pathfix.com/pathfix-keys)**
- Generate your Webhook URI by clicking on the Webhook URI section. Copy the generated URI for use in Quickbooks later
- Click on Save and save the settings



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/nYw7ffg93ggHjZZPotm_m_image.png" size="72" width="1402" height="1098" position="center" showCaption="false"}



- On the Webhooks page, click on **Activate **against Quickbooks to activate your webhook



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/mz8BtrEddO5CulLKaJrV6_image.png" size="72" width="1382" height="1090" position="center" showCaption="false"}



- The webhook activation will take a few minutes and will happen in the background (click on Refresh on the top navigation to refresh the page)
- Once activated, the webhook status will turn **Green**



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/Uzxv0O45cVzjxzqDQ-Uh-_image.png" size="72" width="1387" height="1094" position="center" showCaption="false"}



### Setup in Quickbooks

Now that your webhook has been setup, we need to update the webhook endpoint in Quickbooks so it knows where to send the webhook data to.

- Go to your [Quickbooks developer](https://developer.intuit.com/app/developer/dashboard) app and click on the app name
- Navigate to **Production Settings** and click on **Webhooks**
- Paste the webhook endpoint copied from Pathfix Automation into the **Endpoint URL** section and hit save



![](https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/Fo-fi7u75UoBO2Y48TBlI_image.png)



### Testing Your Webhook Setup

We recommend running a test on your webhook setup to make sure the setup is right. To do this:

- Go to your Pathfix OAuth account and click on Test Connection for Quickbooks
- Click on Connect/Re-Connect and connect a Quickbooks account



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/b1yFXTHJgyp1ZPlRpcyFN_image.png" size="52" width="721" height="721" position="center" showCaption="false"}



- On successful connection, the Automation will start listening for changes in Quickbooks for the connected user
- You will see the webhook user count increase (if it doesnt increase at first, click on **Refresh **on the top navigation)



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/NjrsPIY27K5vgHlC_aRbr_image.png" size="76" width="1390" height="1096" position="center" showCaption="false"}



- Go to your Quickbooks app and create a test entry
- Go to your Pathfix Automation account and click on **Monitor**
- You should see the test event created would have triggered a webhook call



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/Zduo7YBn81mlf0mAFv6Wl_image.png" size="92" width="2170" height="1149" position="center" showCaption="false"}

Your Test is successful.



### Configure Your Automation

Now that your webhook has been setup successfully, you will need to copy the payload sent by Quickbooks and captured by Pathfix Automation and create your Automation.

Here are the few initial steps to get you going:

- Copy the **Request **received from our test event



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/QK4lUiSmmJrzOSSaI_rI-_image.png" size="92" width="2170" height="1149" position="center" showCaption="false"}



- Go to the Automation created and paste the **Request **into the **Call data (JSON) **section of the first task



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/QXNsN-PB1ogpz5cnAG0X5_image.png" size="90" width="2105" height="1182" position="center" showCaption="false"}



- From here, you can call an API, run a condition or process the data as you please through the Automation



::Image[]{src="https://api.archbee.com/api/optimize/4iTydmxMeM2cxR5sP_SIi/J9KP2DTA9WRlGwcLwAuli_image.png" size="90" width="1907" height="1268" position="center" showCaption="false"}



**Important**

- Any changes made to the automation will need to be done in the Dev environment
- Once changes are made, you will first have to Test the Automation and on successful completion then **Publish to Live **
- Please note, without publishing to Live, the changes will not go into effect



Few points to note on the JSON:

1. The pathfix\_user\_id is the same user Id that is sent via the Pathfix OAuth system. This generally is the Current Users Unique Id 
2. the `data` section of the JSON is the exact data that is sent by the provider





Need help? Reach out to our support via support\@pathfix.com or live chat through your Pathfix dashboard