- Category: accounting
- Auth: OAUTH2
- Composio-managed OAuth available? No
- Tools: 74
- Triggers: 0
- Slug:
XERO - Version: 20261101_00
Frequently Asked Questions
How do I set up custom OAuth credentials for Xero?
How do I set up custom OAuth credentials for Xero?
Tools
Allocate Overpayment
Allocate Overpayment
Bulk Create Bank Transactions
Bulk Create Bank Transactions
Bulk Create Invoices
Bulk Create Invoices
XERO_BULK_CREATE_INVOICESCreate multiple Xero invoices or bills. With summarize_errors false (the default), return each success and validation outcome.Input Parameters
Output
Create Bank Transaction
Create Bank Transaction
Create Contact
Create Contact
Create Credit Note
Create Credit Note
XERO_CREATE_CREDIT_NOTECreate a new credit note in Xero. Credit notes are used to reduce amounts owed by customers (ACCRECCREDIT) or to suppliers (ACCPAYCREDIT).Input Parameters
Output
Create File Association
Create File Association
XERO_CREATE_FILE_ASSOCIATIONAssociate a Xero file with an accounting object.Input Parameters
Output
Create Invoice
Create Invoice
XERO_CREATE_INVOICECreate a new invoice in Xero. Supports both sales invoices (ACCREC) and bills (ACCPAY).Input Parameters
Output
Create Item
Create Item
Create Manual Journal
Create Manual Journal
XERO_CREATE_MANUAL_JOURNALCreate a manual journal in Xero with journal lines. Manual journals must balance (debits equal credits).Input Parameters
Output
Create or Update Account
Create or Update Account
XERO_CREATE_OR_UPDATE_ACCOUNTCreate a Xero chart-of-account record, or update one by account ID.Input Parameters
Output
Create Payment
Create Payment
Create Purchase Order
Create Purchase Order
Create Quote
Create Quote
XERO_CREATE_QUOTECreate a new sales quote in Xero for a customer or prospect. Quotes can be sent to contacts for approval and later converted to invoices. Use this action when you need to create a formal price proposal or quotation for goods or services before issuing an invoice.Input Parameters
Output
Create Tracking Option
Create Tracking Option
Delete Item
Delete Item
Download Attachment
Download Attachment
XERO_DOWNLOAD_ATTACHMENTDownload an attachment from a supported Xero accounting entity.Input Parameters
Output
Get Account
Get Account
XERO_GET_ACCOUNTRetrieve a specific account from Xero’s chart of accounts by its unique ID. Returns detailed account information including code, name, type (BANK, REVENUE, EXPENSE, etc.), status (ACTIVE/ARCHIVED), tax settings, bank details (for BANK accounts), and classification. Use XERO_LIST_ACCOUNTS to get account IDs if you don’t already have one.Input Parameters
Output
Get Asset
Get Asset
Get Balance Sheet Report
Get Balance Sheet Report
XERO_GET_BALANCE_SHEET_REPORTRetrieve Balance Sheet report from Xero. Shows assets, liabilities, and equity at a specific date. Liability and credit balances appear as negative numbers in the response. Response structure is Reports → Rows → Sections; account lines are nested inside group sections and summary totals (e.g., ‘Total Current Assets’) appear in SummaryRows.Input Parameters
Output
Get Bank Summary Report
Get Bank Summary Report
Get Bank Transaction
Get Bank Transaction
XERO_GET_BANK_TRANSACTIONRetrieve a specific spent or received money transaction from Xero by its unique bank transaction ID. Returns full transaction details including line items, contact, bank account, amounts, and reconciliation status. Use this action when you need to fetch the details of a specific bank transaction that was previously created.Input Parameters
Output
Get Budget
Get Budget
Get Connections
Get Connections
XERO_GET_CONNECTIONSTool to list active Xero connections. Use to retrieve all current tenant connections for the authenticated user and resolve the correct tenant_id before making data requests. When multiple tenants are returned, never assume the first connection is correct — always explicitly pass the intended tenant_id to every subsequent call. Using a wrong or stale tenant_id can silently return or modify data for a different organisation.Output
Get Contact Aged Report
Get Contact Aged Report
Get Contact History
Get Contact History
Get Contacts
Get Contacts
XERO_GET_CONTACTSTool to retrieve a list of contacts. Use when you need up-to-date contact information with filtering, paging, or incremental updates.Input Parameters
Output
Get Credit Note
Get Credit Note
XERO_GET_CREDIT_NOTERetrieve a specific credit note by ID from Xero. Returns full credit note details including line items, allocations, and status. Use this action when you need to fetch detailed information about a single credit note by its UUID identifier.Input Parameters
a1b2c3d4-...), not the human-readable CreditNoteNumber (e.g. CN-0001); obtain the UUID via XERO_LIST_CREDIT_NOTES first.Output
Get Invoice
Get Invoice
XERO_GET_INVOICERetrieve a specific invoice by ID from Xero. Returns full invoice details including line items and status.Input Parameters
a1b2c3d4-...), not the human-readable InvoiceNumber (e.g. INV-0001); obtain the UUID via XERO_LIST_INVOICES first.Output
Get Item
Get Item
Get Manual Journal
Get Manual Journal
Get Online Invoice
Get Online Invoice
Get Organisation
Get Organisation
XERO_GET_ORGANISATIONRetrieve organisation details from Xero. Returns company info, base currency, timezone, financial year settings, SalesTaxBasis, SalesTaxPeriod, etc. Response fields are nested under data.data.Organisations[0]. Use Timezone when computing date ranges to avoid boundary errors.Input Parameters
Output
Get Payment
Get Payment
XERO_GET_PAYMENTRetrieve a specific payment by ID from Xero. Returns full payment details including associated invoice, account, and reconciliation status. Use this action when you need to inspect a particular payment record to verify its status, amount, or linked transactions.Input Parameters
a1b2c3d4-...), not a payment reference; obtain the UUID via XERO_LIST_PAYMENTS first.Output
Get Profit & Loss Report
Get Profit & Loss Report
XERO_GET_PROFIT_LOSS_REPORTRetrieve a Xero Profit & Loss report showing income, expenses, and net profit; when both dates are supplied, their range cannot exceed 365 days. Parse labeled report rows by label rather than index; the report aggregates tax codes and is not suitable for tax compliance reporting.Input Parameters
Output
Get Project
Get Project
Get Purchase Order
Get Purchase Order
Get Quotes
Get Quotes
Get Record History
Get Record History
Get Repeating Invoice
Get Repeating Invoice
Get Trial Balance Report
Get Trial Balance Report
XERO_GET_TRIAL_BALANCE_REPORTRetrieve Trial Balance report from Xero. Shows all account balances (debits and credits) at a specific date. Use to verify that total debits equal total credits and to prepare financial statements. Credit balances appear as negative numbers in the response.Input Parameters
Output
List Accounts
List Accounts
XERO_LIST_ACCOUNTSRetrieve Xero’s chart of accounts, with optional filtering and ordering. AccountID uniquely identifies an account.Input Parameters
Output
List Advance Payments
List Advance Payments
List Assets
List Assets
XERO_LIST_ASSETSRetrieve fixed assets from Xero by status, defaulting to DRAFT. Assets track depreciation and book value of capital equipment.Input Parameters
Output
List Attachments
List Attachments
List Bank Transactions
List Bank Transactions
XERO_LIST_BANK_TRANSACTIONSRetrieve bank transactions from Xero. Includes SPEND, RECEIVE, and transfer types; unfiltered results include DELETED transactions that skew totals. Dates returned in /Date(milliseconds_since_epoch)/ format. Rate limit: ~60 requests/minute per org; heavy pagination may trigger 429 errors.Input Parameters
Output
List Batch Payments
List Batch Payments
List Credit Notes
List Credit Notes
List Organisation Currencies
List Organisation Currencies
List File Associations
List File Associations
List Files
List Files
List Folders
List Folders
List Invoices
List Invoices
XERO_LIST_INVOICESRetrieve a list of invoices from Xero. Results include both sales invoices (Type=ACCREC) and bills (Type=ACCPAY) by default; filter by Type in the where clause when only one is needed. Supports filtering by status, contact, date range, and pagination.Input Parameters
pagination.pageCount in the response to retrieve all records.Output
List Items
List Items
List Journals
List Journals
XERO_LIST_JOURNALSRetrieve journals from Xero, with optional modified-since and payment-only filters and offset pagination. Journals show accounting entries for transactions and are returned in a Journals array.Input Parameters
Output
List Manual Journals
List Manual Journals
List Payments
List Payments
XERO_LIST_PAYMENTSRetrieve list of payments from Xero. Payments link invoices to bank transactions; invoices may have multiple partial/split payment records. Response Date fields use Xero’s /Date(milliseconds)/ format requiring custom parsing.Input Parameters
Output
List Projects
List Projects
List Project Time Entries
List Project Time Entries
List Purchase Orders
List Purchase Orders
List Quotes
List Quotes
XERO_LIST_QUOTESRetrieve a list of sales quotes from Xero with optional filtering and pagination. Supports filtering by date ranges, contact, status, and quote number. Returns up to 100 quotes per page with full line item details. Use this action when you need to query, list, or search for quotes in a Xero organization.Input Parameters
Output
List Tax Rates
List Tax Rates
XERO_LIST_TAX_RATESRetrieve tax rates from Xero. Shows available tax codes and rates for the organization. Use returned tax codes as valid TaxType values in other tools — invalid values cause ValidationException errors.Input Parameters
Output
List Tracking Categories
List Tracking Categories
List Organisation Users
List Organisation Users
Update Invoice
Update Invoice
Update Bank Transaction
Update Bank Transaction
XERO_UPDATE_BANK_TRANSACTIONUpdate an existing bank transaction in Xero. Use this action when you need to modify details of a previously created bank transaction such as line items, reference, date, or status. Note: Reconciled transactions cannot be updated and will return a validation error.Input Parameters
Output
Update Contact
Update Contact
Update Credit Note
Update Credit Note
XERO_UPDATE_CREDIT_NOTEUpdates a specific credit note in Xero by its unique identifier. This action allows you to modify credit note details such as status, line items, reference numbers, and other fields after the credit note has been created. Use this action when you need to change the status of a credit note (e.g., from DRAFT to AUTHORISED), update line items, modify reference information, or make other changes to an existing credit note. The credit note must already exist in Xero - use the credit_note_id to specify which credit note to update. Not all fields can be updated depending on the current status of the credit note.Input Parameters
Output
Update Item
Update Item
Update Manual Journal
Update Manual Journal
XERO_UPDATE_MANUAL_JOURNALUpdate an existing manual journal (journal entry) in Xero by its ID. Use this action when you need to modify the narration, date, journal lines, status, or other properties of an existing manual journal. Manual journals must balance (debits equal credits) or the update will fail. Only DRAFT manual journals can have their journal lines updated; POSTED journals can have limited fields updated.Input Parameters
Output
Update Purchase Order
Update Purchase Order
XERO_UPDATE_PURCHASE_ORDERUpdates a specific purchase order in Xero by its unique identifier. Use this action when you need to modify an existing purchase order’s details such as line items, delivery information, status, or other fields. Only the fields provided in the request will be updated; fields not included will remain unchanged.Input Parameters
Output
Update Quote
Update Quote
XERO_UPDATE_QUOTEUpdates a specific quote in Xero by its QuoteID. Use this action when you need to modify an existing sales quote, such as changing its status, updating line items, contact details, dates, or other quote properties. Only the fields provided in the request will be updated - unprovided fields will remain unchanged.Input Parameters
Output
Upload Attachment
Upload Attachment
XERO_UPLOAD_ATTACHMENTUpload a file attachment to a Xero entity (invoice, contact, etc.). Supports PDF, images, and documents.