> For the complete documentation index, see [llms.txt](https://docs.helpyousponsor.com/guides/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helpyousponsor.com/guides/advanced-features/integrations/quickbooks/connect-to-helpyousponsor.md).

# Connect to HelpYouSponsor

#### **1. Accessing the Integration**

* Go to the main menu and click **Settings → Integrations**.
* Locate the **QuickBooks** card.<br>

  <figure><img src="/files/bBnaLwArMbMQgugvFUnH" alt=""><figcaption></figcaption></figure>

Click **Sign in to QuickBooks** to begin the connection process.

***

#### **2. Authorizing QuickBooks**

After clicking **Sign in to QuickBooks, a** right-side drawer will open.

<figure><img src="/files/71izVbeBkN8kghFVCei0" alt=""><figcaption></figcaption></figure>

This drawer lists all your **Programs** in HelpYouSponsor. Each program can later be mapped to QuickBooks Online (QBO) fields so data syncs smoothly between the two systems.

Click **Authorize QuickBooks** to begin onboarding.

You’ll then:

1. Be redirected to QuickBooks Online.
2. Choose the **company** you want to link to HelpYouSponsor.

   <figure><img src="/files/UFZG2tHYjHRzjFlLo3Hk" alt=""><figcaption></figcaption></figure>
3. Confirm your selection.
4. After connecting, you’ll return to the **Integrations** page.

The **QuickBooks card** will now be toggled **ON**, confirming a successful connection.

<figure><img src="/files/LQKkVWU7vyzGSCFLbhys" alt=""><figcaption></figcaption></figure>

***

### **Field Mappings**

HelpYouSponsor supports mappings for **Customers** and **Items**.

#### **1. Mapping Customers**

1. In the right-side drawer, select the **Program** whose donor data you want to link to QuickBooks.<br>

   <figure><img src="/files/hy05fk7j8O5046EmtM53" alt=""><figcaption></figcaption></figure>
2. Under the **Customer** tab, you’ll see the **Donor Form Fields** for that program.
3. Use the dropdown menus to match each donor field with a corresponding **QuickBooks field**.

   <figure><img src="/files/6CFdC5rdcWhI6XBaMR4R" alt=""><figcaption></figcaption></figure>

***

#### **2. Mapping Service Items**

1. Go to the **Service Item** tab.
2. You’ll see the **Recipient Form Fields** you created.
3. Use the dropdown menus to map these fields with **QuickBooks item fields**.<br>

   <figure><img src="/files/p3ADhjvqsn7hhNqVfXL6" alt=""><figcaption></figcaption></figure>

***

#### **3. Accounting Settings**

Under the **Accounting** tab, two key elements can be linked:

* **Chart of Accounts** — available from your QuickBooks organization account.

  <figure><img src="/files/I3kbchXtTgvHNyRGmFHn" alt=""><figcaption></figcaption></figure>

  <figure><img src="/files/rCDquAQvrHkxQ2OCeYiS" alt=""><figcaption></figcaption></figure>
* **Class** — the class list as configured in your QuickBooks account.

  <figure><img src="/files/jMMTguEB8hLL0Q66hx7s" alt=""><figcaption></figcaption></figure>

  <figure><img src="/files/Dxxy7OentRruyEoJqNMs" alt=""><figcaption></figcaption></figure>

### **Data Sync Behavior**

Once your integration is complete:

* **Newly created donations, customers, and items** will automatically sync to QuickBooks.
* **Data created before integration** will not sync retroactively.

***

### **Error Handling**

If you encounter an error message like the one below:

<figure><img src="/files/O4DksHEjOuVPNkrMNyng" alt=""><figcaption></figcaption></figure>

Don’t worry — this simply means your QuickBooks connection needs to be refreshed.\
Click **Reauthorize** to restore your connection.

In rare cases, if further action is needed, the system will notify you when user intervention is required.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.helpyousponsor.com/guides/advanced-features/integrations/quickbooks/connect-to-helpyousponsor.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
