Skip to main content

Permission error when sending settlement to Xero

Applies to error message "You Are Not Permitted to Access This Resource"

Written by Ruth Buan
Updated yesterday

What this error means

This error appears when Link My Books tries to send a settlement to Xero, but the Xero user connected to Link My Books does not have the required permissions to create transactions, or the Xero connection itself has gone stale.

Xero requires the connected user to have sufficient access rights in order to create invoices or bills.


Why this happens

Common reasons include:

  • The Xero user connected to Link My Books does not have full access

  • The user's permissions in Xero were changed after the connection was created

  • The integration was authorised using a restricted user account

  • The Xero connection has gone stale after a billing reactivation, an extended period of inactivity, or a paused subscription that has now been restarted

Because of these permission or connection issues, Xero rejects the request.


How to resolve it

Reconnect Xero using a user with the correct permissions. The cleanest way to do this is to remove Link My Books from Xero's Linked Apps first, then re-authorise from inside Link My Books.

Steps:

  1. Log in to Xero and go to Settings β†’ Connected apps (or Linked apps).

  2. Find Link My Books in the list and click Disconnect or Remove.

  3. Log in to Link My Books.

  4. Go to Settings β†’ Account Settings.

  5. Click Reconnect Xero in the Action dropdown.

  6. Authorise the connection using a user with full access in Xero.

Once the connection is re-established, return to the Settlements dashboard and send the settlement again.

Removing Link My Books from Xero's Linked Apps before reconnecting forces a clean re-authorisation. This is especially helpful if your subscription was recently reactivated or if the connection has been working until now and has suddenly started failing.


When to contact Link My Books support

Contact Link My Books support if:

  • the Xero user has full permissions but the error still appears

  • the settlement continues to fail after reconnecting Xero

Please include:

  • the settlement ID

  • the exact error message

  • the events or steps that led to the error (for example, recent billing changes, paused subscription, or password reset in Xero)

  • a screenshot if possible

This helps our team investigate the issue more quickly.

If you have any questions about this article or feedback on how we could make it better please reach out to the support team via the blue chat icon on the bottom right of the page or via email to [email protected].

Did this answer your question?