What this error means
You may see an error like:
Account Code Archived
Account Code Invalid
Missing Accounting Codes
Deleted Account Reference
Failed to save accounts (this one happens during the setup wizard rather than when a settlement posts — see the section at the bottom of this article)
This error appears when Link My Books tries to send a settlement to your accounting software, but one of the accounts or tax codes referenced in the transaction is no longer valid.
This usually happens when an account that Link My Books is configured to use has been deleted, archived, or changed in Xero or QuickBooks.
Why this happens
Common reasons include:
An account used by Link My Books was archived in Xero or QuickBooks
An account was deleted or renamed
A tax code referenced by Link My Books is no longer available
The account mapping in Link My Books was not fully completed
Because the account or code cannot be found, the accounting platform rejects the transaction.
How to resolve it
Check the account mappings used by Link My Books.
Steps:
Open Link My Books
Go to Accounting & Taxes settings
Review your account and tax mappings
Ensure all required accounts and tax codes are selected
You should also check in Xero or QuickBooks that:
the mapped account still exists
the account has not been archived
the tax code used in the mapping is active
If an account was deleted or archived, either restore the account or update the mapping in Link My Books.
"Failed to save accounts" during the Setup Wizard
If you see "Failed to save accounts" while completing the Accounts & Taxes wizard — rather than when a settlement posts — that is a different problem from the errors above, and it is documented in full in How to Set Up Your Account and Tax Rate Mappings, under Troubleshooting setup wizard errors.
✅ Worth knowing before you contact us: several causes of that error you can fix yourself, including an expired free trial — take out a subscription and re-run the wizard. The other causes covered there are accounts with conflicting names or codes in your bookkeeping software, permission restrictions on the connected bookkeeping account, a stale sales channel connection, and the same marketplace seller ID already being connected to another Link My Books account.
When to contact Link My Books support
Contact Link My Books support if:
you cannot identify which account is causing the error
all accounts appear active but the error still occurs
the settlement continues to fail after updating the mappings
Please include:
the settlement ID
the exact error message
the events or steps that led to the error
a screenshot if possible
This will help our team investigate more quickly.
