Skip to content

Xero integration support

How to connect one Xero organisation, which paid sales invoices start a request, and how credits, disconnecting, and troubleshooting work.

Last updated: November 1, 2026

Coming soon: connecting Xero directly

The direct Xero connection isn't open yet. We're finishing Xero's app review, and this guide describes how it will work. Until then, you can connect Xero to ReviewNudger through Zapier.

Data flow

Data moves from Xero to ReviewNudger only. ReviewNudger never creates or edits invoices, contacts, payments, or credit notes in Xero.

Direction: Xero → ReviewNudger. Data written back to Xero: none.

What we read from Xero

Access we ask Xero for. offline_access, accounting.invoices.read, and accounting.contacts.read. The separate optional signup button requests only openid profile email.

Accepted trigger. A customer sales invoice, current status PAID, a positive AmountPaid, no already-applied credit, and a contact with a usable email address or phone number.

Not accepted. Draft, submitted, authorised, voided, accounts-payable, zero-payment, already-credited, or contactless invoices do not create a request.

Timing. Xero sends a notice after a change. ReviewNudger saves it quickly, then looks up the current invoice and contact in the background. Short delays and automatic retries are normal.

Duplicate safety. Repeated notices and invoice updates stay tied to the same Xero organisation and invoice. They cannot create a second review-request journey.

Credits and refunds

Sometimes a customer credit note is applied to an invoice ReviewNudger already accepted. ReviewNudger records that, but does not create another request. If the request has not sent yet, it is canceled. If its first message already sent, that message cannot be recalled. All remaining follow-ups stop. Removing a credit later does not restart them.

Disconnect and delete

Disconnect Xero. Account owners can use Dashboard → Settings → Connected apps → Xero → Disconnect. ReviewNudger deletes the matching tenant connection at Xero. It also clears its stored access and refresh tokens. New Xero events stop processing.

Change organisation. Disconnect first, then reconnect and choose the replacement organisation. One ReviewNudger account cannot bind to two Xero organisations.

Delete the account. Deleting your account in the dashboard first revokes the Xero connection. Then it deletes the account's connection, invoice-event, customer, review-request, and delivery records. If Xero cannot be reached, deletion stops and shows an error. That way access is never silently left behind.

See the privacy policy for retention details or email support@reviewnudger.com for an export or deletion request.

Troubleshooting

The connection needs attention. Reconnect from Settings. Refresh tokens rotate. A revoked or expired Xero grant cannot be fixed without your approval.

A paid invoice did not create a request. Check that it is a customer sales invoice with PAID status, positive AmountPaid, no applied credit, and usable contact details. Then check Recent events. It shows whether the event was ignored, failed, suppressed, or processed, and why.

The event is still retrying. Busy periods and temporary Xero errors are retried automatically for a limited time. The connection panel records the latest error. Do not pay or edit the invoice again to force a duplicate event.

You need help. Email support@reviewnudger.com with your ReviewNudger business name, the Xero invoice number, and roughly when it was paid. Never send passwords, sign-in codes, or secret keys. We reply within two business days.

FAQ

Does ReviewNudger change my books? No. The integration asks only to read invoices and contacts. It writes nothing to Xero.

Can I use multiple locations or organisations? Not in the launch flow. One ReviewNudger account supports one location and one connected Xero organisation.

Does every payment start a request? No. Only a customer sales invoice that is fully PAID with a positive AmountPaid starts one. Other payments and bank reconciliation events do not.

Where can I learn about Xero? Xero is cloud accounting software for invoicing, reconciliation, expenses, payroll, reporting, and other accounting tasks.

← All support