---
title: Sync Faults caused by Xero user permission restrictions
description: Sync issues caused by Xero permissions
---

[Skip to content](https://kb.clouddepot.com/knowledge/sync-faults-xero-permission-restrictions#main-content)

English

Show submenu for translations

![CoudDepot\_LOGO\_RGB.png\]](https://kb.clouddepot.com/hs-fs/hubfs/CoudDepot_LOGO_RGB.png?height=40&name=CoudDepot_LOGO_RGB.png)

- [Read Our Blog](https://blog.clouddepot.com/)

Open main navigation

Close main navigation

- [Read Our Blog](https://blog.clouddepot.com/)
- English
  
  Show submenu for translations
- [Go to clouddepot.com](https://www.clouddepot.com/)

[Go to clouddepot.com](https://www.clouddepot.com/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Cloud Depot Knowledge Base](https://kb.clouddepot.com/knowledge?hsLang=en)
2. [Product - Autotask to Xero](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en)
3. [Troubleshooting](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#troubleshooting)

# Sync Faults caused by Xero user permission restrictions

## Some customers might be experiencing sync faults due to a update to how Xero handles users permissions

### **Issue Detected — Sync Fault from Xero**

This guide explores the recent security changes implemented by Xero and provides instructions on how to resolve the authorization error preventing contacts from syncing between Cloud Depot and Xero.

### **1. Why am I seeing this error?**

On **29 June 2026**, Xero Developer Relations rolled out a major security upgrade that strictly aligns third-party API actions with internal user roles and permissions managed inside Xero Central.

Previously, external connections could sometimes bypass specific user boundaries. With this new update, Xero explicitly enforces real-time permissions: **if the specific user who originally connected Cloud Depot to Xero does not have the necessary high-level clearance, the sync will instantly fail.**

Common reasons this error occurs:

- You currently have the **“Update Xero contacts”** option enabled in Cloud Depot. As a temporary workaround, **you can disable this option.**
- The user who connected the integration has a **Read Only** or restricted **Invoice Only** role.
- The connecting user is a **Standard** user but has had specific user-level restrictions applied to their account and the **BankAccountAdmin** permission is unticked.

### **2. How to Fix the Permission Issue**

#### **Step 1: Check Xero User Settings**

1. Log into Xero and navigate to your organization's user settings.
2. Ensure the user performing the reconnection holds a **Standard** or **Advisor** role with no custom feature restrictions applied.
3. **Important:** When we update Xero contacts we require the **BankAccountAdmin** option to be selected (even though we do not populate that field) 
   
   ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jun-30-2026-07-33-26-9781-PM.png?width=670&height=397&name=image-png-Jun-30-2026-07-33-26-9781-PM.png)

#### **Step 2: Reconnect Xero to Cloud Depot**

[After making the permission changes in Step 1 you might be required to re-connect to Xero please see step 2 from the KB below.](https://kb.clouddepot.com/knowledge/connecting-to-xero-oauth-2.0?hsLang=en)

 

- [Product - Autotask to Xero](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#main-content)

    - [Getting Started](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#getting-started)
    - [Setup](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#setup)
    - [Troubleshooting](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#troubleshooting)
- [Product - Recurring Payment Service (RPS)](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#main-content)

    - [Getting Started](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#getting-started)
    - [Customers & Invoices](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#customers-invoices)
    - [Payment Rules & Auto Pay](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#payment-rules-auto-pay)
    - [Customer Portal](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#customer-portal)
    - [Surcharges](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#surcharges)
    - [Payment Gateways](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#payment-gateways)
    - [Troubleshooting](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#troubleshooting)
- [Product - HostedPay](https://kb.clouddepot.com/knowledge/product-hostedpay?hsLang=en)
- [Integrations](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#main-content)

    - [Xero](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#xero)
    - [Autotask](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#autotask)
    - [HaloPSA](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#halopsa)
- [Support, security & updates](https://kb.clouddepot.com/knowledge/support-security-updates?hsLang=en)
- [Billing and Accounting](https://kb.clouddepot.com/knowledge/billing-and-accounting?hsLang=en)
- [Setting up Cloud Depot](https://kb.clouddepot.com/knowledge/setting-up-cloud-depot?hsLang=en)
- [Cloud Depot Status and Contacting Support](https://kb.clouddepot.com/knowledge/cloud-depot-status-and-contacting-support?hsLang=en#main-content)

    - [View Service Status](https://kb.clouddepot.com/knowledge/cloud-depot-status-and-contacting-support?hsLang=en#view-service-status)
    - [Support](https://kb.clouddepot.com/knowledge/cloud-depot-status-and-contacting-support?hsLang=en#support)
- [Sync Customization Documentation](https://kb.clouddepot.com/knowledge/sync-customization-documentation?hsLang=en)

- [Read Our Blog](https://blog.clouddepot.com/)

# Cloud Depot

Cloud Depot Help Center

Copyright © 2026, Cloud Depot