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

# Common HubSpot-Xero Errors & Fixes

<AccordionGroup>
  <Accordion title="1. Xero Account Disconnected">
    ![Xero Account Disconnected](https://t3415972.p.clickup-attachments.com/t3415972/9dfdfedd-fdb2-4330-b6f5-b53783687de0/image.png)

    **Why this happens:** The connection with Xero has expired.

    **How to fix this:**

    1. Open the **Xero Integration by Cloudify** app from **Connected Apps**.
    2. Navigate to **Settings** and click the **Connect/Disconnect Xero** button.
    3. Reconnect your Xero account.
  </Accordion>

  <Accordion title="2. Missing Company or Contact in HubSpot Deal">
    ![Missing Company or Contact](https://t3415972.p.clickup-attachments.com/t3415972/c9c544d0-983e-4d76-af3d-3493a6fa7c00/image.png)

    **Why this happens:** A company is either not associated with the deal, or the app settings are not enabled to sync when only a contact is associated with the deal.

    **How to fix this:**

    **If no Company or Contact is associated with the deal:**

    Add a **Company or Contact** to the deal, then change the deal stage back and forth to re-trigger the integration.

    **If only a Contact is associated with the deal (B2C):**

    1. Open the **Xero Integration by Cloudify** app from **Connected Apps**.
    2. Navigate to **Settings** → **Sync Settings**.
    3. Under **Customer Sync Rules**, enable **Contact (B2C) Sync**.
    4. Set your preferred customer matching criteria between **HubSpot Contact** and **Xero Customer**.
    5. Click **Save** to apply the changes.
  </Accordion>

  <Accordion title="3. Account Is Not Valid as a Default Account">
    ![Account Not Valid](https://t3415972.p.clickup-attachments.com/t3415972/59f734c8-18a9-4255-a5ec-2334828e00ea/image.png)

    **Why this happens:** The sales account mapped under customer default mappings is not suitable for revenue posting. The account must be of type **Revenue** in Xero.

    **How to fix this:**

    1. Open the **Xero Integration by Cloudify** app from **Connected Apps**.
    2. Navigate to **Settings** → **Customers** → **Customer Default Mappings**.
    3. Locate **Default Sales Account** and select the correct revenue-type account from the dropdown.
    4. Click **Save** to apply the changes.
  </Accordion>

  <Accordion title="4. Product / Line Item Not Present in HubSpot Deal">
    ![Product Not Present](https://t3415972.p.clickup-attachments.com/t3415972/7ee8548f-39e6-40dd-9a9d-00b55311d6ef/image.png)

    **Why this happens:** No line item or product is associated with the HubSpot deal. A line item is required to create an invoice in Xero, so the integration cannot proceed without one.

    **How to fix this:**

    You can either add a product to the deal in HubSpot, or configure a default Xero product to use as a fallback line item.

    **To use a default Xero product (no deal product required):**

    1. Open the **Xero Integration by Cloudify** app from **Connected Apps**.
    2. Navigate to **Settings** → **Products**.
    3. Locate the **"Do You Have Deals Without Products?"** section and enable the checkbox.
    4. Select a Xero product from the dropdown list.
    5. Click **Save** to apply the changes.
  </Accordion>

  <Accordion title="5. Account type is invalid for making a payment">
    <Frame>
      <img src="https://mintcdn.com/cloudify-c7720744/R_a6ou1tjG83z_dn/images/image-601.png?fit=max&auto=format&n=R_a6ou1tjG83z_dn&q=85&s=16f631c6e987f4fb7e5a4094471bab62" alt="Image" width="1280" height="209" data-path="images/image-601.png" />
    </Frame>

    **Why this happens:** Xero only allows payments to be posted against accounts that have payments enabled in your Chart of Accounts. If the account used for this transaction doesn't have that setting turned on, Xero rejects the payment and the sync fails. Enabling payments for the relevant account resolves the error.

    **How to fix this:**

    * In Xero, go to **Settings → Chart of Accounts**.
    * Select the account used to create the paid invoice in Xero.
    * Tick the **Enable payments to this account** checkbox and save.
    * Return to the HubSpot–Xero integration and rerun the failed sync. The invoice should now be created successfully.
  </Accordion>
</AccordionGroup>