Skip to main content

Xero

Xero connector for managing contacts, invoices, payments, bank transactions, and accounting settings.

Categories: Accounting, Finance, Invoicing

What you can ask​

  • List unpaid invoices over 30 days past due, by customer.
  • Pull total revenue by tracking category for Q1.
  • Find expenses tagged client-billable that haven't been invoiced.

Set up​

Xero needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Xero. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Xero developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Xero login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (12)

Grant the scopes for the tools you plan to allow.

  • accounting.banktransactions
  • accounting.banktransactions.read
  • accounting.contacts
  • accounting.contacts.read
  • accounting.invoices
  • accounting.invoices.read
  • accounting.manualjournals
  • accounting.manualjournals.read
  • accounting.payments
  • accounting.payments.read
  • accounting.settings
  • accounting.settings.read

Tools​

Xero offers 48 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (27)​

View and search information without changing it.

ToolWhat it does
get_accountGet a single account by ID with full details including reporting codes.
get_bank_transactionGet a single bank transaction by ID with full details including line items.
get_contactGet a single contact by ID with full details including addresses and phone numbers.
get_credit_noteGet a single credit note by ID with full details including line items and remaining credit.
get_invoiceGet a single invoice by ID with full details including line items, amounts, and payment status.
get_itemGet a single item by ID with full details including purchase and sales details.
get_manual_journalGet a single manual journal by ID with full details including journal lines.
get_organisationGet the current Xero organisation details including name, currency, country, and financial year settings.
get_paymentGet a single payment by ID with full details including related invoice and account info.
get_purchase_orderGet a single purchase order by ID with full details including line items and delivery info.
get_quoteGet a single quote by ID with full details including line items and terms.
list_accountsList all chart of accounts.
list_bank_transactionsList bank transactions with pagination (100 per page).
list_branding_themesList all branding themes.
list_connectionsList all connected Xero organisations (tenants).
list_contactsList contacts with pagination (100 per page).
list_credit_notesList credit notes with pagination (100 per page).
list_currenciesList all currencies enabled in the organisation.
list_invoicesList invoices with pagination (100 per page).
list_itemsList all items (products/services).
list_manual_journalsList manual journals with pagination (100 per page).
list_paymentsList payments with pagination.
list_purchase_ordersList purchase orders with pagination (100 per page).
list_quotesList quotes with pagination (100 per page).
list_tax_ratesList all tax rates configured in the organisation.
list_tracking_categoriesList all tracking categories and their options.
validate_credentialValidate Xero credentials by listing connected organisations.

Write (11)​

Create or send data.

ToolWhat it does
create_accountCreate a new account in the chart of accounts.
create_bank_transactionCreate a bank transaction.
create_contactCreate a new contact.
create_credit_noteCreate a credit note.
create_invoiceCreate a new invoice.
create_itemCreate a new item (product/service).
create_manual_journalCreate a manual journal.
create_paymentCreate a payment against an invoice or credit note.
create_purchase_orderCreate a purchase order.
create_quoteCreate a quote.
email_invoiceEmail an invoice to the contact.

Delete or overwrite (10)​

Remove or replace existing data.

ToolWhat it does
archive_contactArchive a contact by setting its status to ARCHIVED.
delete_itemDelete an item.
update_bank_transactionUpdate a bank transaction.
update_contactUpdate an existing contact.
update_credit_noteUpdate a credit note.
update_invoiceUpdate an existing invoice.
update_manual_journalUpdate a manual journal.
update_purchase_orderUpdate a purchase order.
update_quoteUpdate a quote.
void_invoiceVoid an invoice.
⌘J