Fixing Contact Sync Errors in Loft47

This guide shows how to identify and fix Loft47–Xero/QBO contact sync errors caused by duplicate or incorrectly linked contacts, including blocking/non-blocking contact errors.

Grace Truong
13 steps
2 minutes

Click the Integrations option in the left sidebar. This opens the integrations settings page where you can manage connected services.

Click the Accounting option under Integrations. This example navigates to the Xero integration activity and settings page.

Click the Activity option under Xero in the left sidebar. This opens the Xero Activity page where you can monitor sync status and view recent sync logs.

Scroll down the Xero Activity page. This allows you to review the status of recent contact and transaction batch syncs, **including any warnings or errors.**

Click the warning entry under the Status column for the contact batch. This opens the details of the batch to investigate any sync errors.

Click the Non-blocking contacts link. This expands the error details to show which contacts failed to sync and why.

Analyze the Xero sync error details to identify the root cause. The most common error is that contact names must be unique across all active contacts in Xero.

Click the contact link in the error message. This opens the contact's profile page in Loft47 so you can verify and correct their integration settings.

Review the contact's profile details to ensure they are set up correctly. **If the agent has an organization configured, you must link the organization instead of the individual agent profile.**

Scroll to the **Xero Contacts** section on the contact’s profile.\ Click **Unlink** next to the linked Xero contact.

Search the correct Xero contact.

Relink the correct Xero contact to this profile.

Re-run **Sync to Xero / QBO** to refresh the updated contacts.\ This should resolve the sync error and allow the contact to sync successfully.

Fixing Contact Sync Errors in Loft47

This guide shows how to identify and fix Loft47–Xero/QBO contact sync errors caused by duplicate or incorrectly linked contacts, including blocking/non-blocking contact errors.

Grace Truong
13 steps
2 minutes