Xero

Version: 0.1.1
Database part: Yes

The contract

Takes an invoice or a payment. Posts it to Xero and returns the result.

Settings

Name	What it does
tenantId	The Xero organisation to post to, as its tenant id, passed in the connection.
baseUrl	Where the accounting API is reached, passed in the connection. Defaults to Xero's own. Set it to use a gateway.
tokenUrl	Where xeroClientCredentials signs in. Defaults to Xero's identity service.
scopes	The scopes xeroClientCredentials asks for. Defaults to accounting.transactions.
timeoutMs	How long one call to Xero may take, passed in the connection. Defaults to 30 seconds.

Requires

Live demo

Build an invoice

The block checks every field before anything is recorded or sent. Change a value to see what it refuses.

Kind of invoice

Status when it arrives in Xero

Contact id from Xero

Invoice date

Due date

Reference

Currency

Lines

Description of line 1

Quantity on line 1

Unit amount on line 1

Account code on line 1

Tax type on line 1

Description of line 2

Quantity on line 2

Unit amount on line 2

Account code on line 2

Tax type on line 2

What would be sent to Xero

{
  "Type": "ACCREC",
  "Contact": {
    "ContactID": "7c3f5a1e-4b2d-4e8a-9f61-2a5d8c0b1e34"
  },
  "LineItems": [
    {
      "Description": "Monthly bookkeeping",
      "Quantity": 1,
      "UnitAmount": 450,
      "AccountCode": "200",
      "TaxType": "OUTPUT"
    },
    {
      "Description": "Payroll run",
      "Quantity": 2,
      "UnitAmount": 35.5,
      "AccountCode": "200",
      "TaxType": "OUTPUT"
    }
  ],
  "Date": "2026-11-13",
  "DueDate": "2026-11-27",
  "Reference": "Work order 104",
  "CurrencyCode": "AUD",
  "Status": "DRAFT"
}

Build a payment

Invoice id from Xero

Bank account code

Amount paid

Date paid

Payment reference

What would be sent to Xero

{
  "Invoice": {
    "InvoiceID": "b1e2c3d4-5f60-4a7b-8c9d-0e1f2a3b4c5d"
  },
  "Account": {
    "Code": "090"
  },
  "Amount": 521,
  "Date": "2026-11-20",
  "Reference": "Bank transfer"
}