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-billablethat 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.
- Go to Organization > Connectors and find Xero. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Xero developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- 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.banktransactionsaccounting.banktransactions.readaccounting.contactsaccounting.contacts.readaccounting.invoicesaccounting.invoices.readaccounting.manualjournalsaccounting.manualjournals.readaccounting.paymentsaccounting.payments.readaccounting.settingsaccounting.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.
| Tool | What it does |
|---|---|
get_account | Get a single account by ID with full details including reporting codes. |
get_bank_transaction | Get a single bank transaction by ID with full details including line items. |
get_contact | Get a single contact by ID with full details including addresses and phone numbers. |
get_credit_note | Get a single credit note by ID with full details including line items and remaining credit. |
get_invoice | Get a single invoice by ID with full details including line items, amounts, and payment status. |
get_item | Get a single item by ID with full details including purchase and sales details. |
get_manual_journal | Get a single manual journal by ID with full details including journal lines. |
get_organisation | Get the current Xero organisation details including name, currency, country, and financial year settings. |
get_payment | Get a single payment by ID with full details including related invoice and account info. |
get_purchase_order | Get a single purchase order by ID with full details including line items and delivery info. |
get_quote | Get a single quote by ID with full details including line items and terms. |
list_accounts | List all chart of accounts. |
list_bank_transactions | List bank transactions with pagination (100 per page). |
list_branding_themes | List all branding themes. |
list_connections | List all connected Xero organisations (tenants). |
list_contacts | List contacts with pagination (100 per page). |
list_credit_notes | List credit notes with pagination (100 per page). |
list_currencies | List all currencies enabled in the organisation. |
list_invoices | List invoices with pagination (100 per page). |
list_items | List all items (products/services). |
list_manual_journals | List manual journals with pagination (100 per page). |
list_payments | List payments with pagination. |
list_purchase_orders | List purchase orders with pagination (100 per page). |
list_quotes | List quotes with pagination (100 per page). |
list_tax_rates | List all tax rates configured in the organisation. |
list_tracking_categories | List all tracking categories and their options. |
validate_credential | Validate Xero credentials by listing connected organisations. |
Write (11)
Create or send data.
| Tool | What it does |
|---|---|
create_account | Create a new account in the chart of accounts. |
create_bank_transaction | Create a bank transaction. |
create_contact | Create a new contact. |
create_credit_note | Create a credit note. |
create_invoice | Create a new invoice. |
create_item | Create a new item (product/service). |
create_manual_journal | Create a manual journal. |
create_payment | Create a payment against an invoice or credit note. |
create_purchase_order | Create a purchase order. |
create_quote | Create a quote. |
email_invoice | Email an invoice to the contact. |
Delete or overwrite (10)
Remove or replace existing data.
| Tool | What it does |
|---|---|
archive_contact | Archive a contact by setting its status to ARCHIVED. |
delete_item | Delete an item. |
update_bank_transaction | Update a bank transaction. |
update_contact | Update an existing contact. |
update_credit_note | Update a credit note. |
update_invoice | Update an existing invoice. |
update_manual_journal | Update a manual journal. |
update_purchase_order | Update a purchase order. |
update_quote | Update a quote. |
void_invoice | Void an invoice. |