Xero integration support
A precise guide to connecting one Xero organisation, the paid-sales-invoice trigger, customer credits, disconnection, and troubleshooting.
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.
Contents
Data flow
Data moves from Xero to ReviewNudger only. ReviewNudger never creates or edits invoices, contacts, payments, or credit notes in Xero.
Xero
Paid sales invoice, attached contact, and later credits
Verified event receipt
Verified notice from Xero, current invoice and contact lookup, duplicate protection
Review-request journey
Saved delay, channel, opt-out, wait-before-asking-again, delivery, and follow-up rules
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
When a customer credit note is applied to a previously accepted invoice, ReviewNudger records that fact without creating another request. If the request has not sent yet, it is canceled. If its first message already sent, that message cannot be recalled, but all remaining follow-ups stop. Removing a credit later does not restart the stopped journey.
Disconnect and delete
Disconnect Xero. Account owners can use Dashboard → Settings → Connected apps → Xero → Disconnect. ReviewNudger deletes the matching tenant connection at Xero and 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. Dashboard account deletion first revokes the Xero connection, then deletes the account-owned connection, invoice-event, customer, review-request, and delivery records. If Xero cannot be reached, deletion stops with a visible error so 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, and a revoked or expired Xero grant cannot be repaired without your approval.
A paid invoice did not create a request. Confirm it is a customer sales invoice with PAID status, positive AmountPaid, no applied credit, and usable contact details. Then check Recent events for the recorded ignored, failed, suppressed, or processed reason.
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 requests read-only invoice and contact scopes and 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. The boundary is the fetched customer sales invoice being fully PAID with a positive AmountPaid, not an arbitrary payment or bank reconciliation event.
Where can I learn about Xero? Xero is cloud accounting software for invoicing, reconciliation, expenses, payroll, reporting, and other accounting workflows.
