Skip to content

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.

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.

← All support