Xero · OAuth Scopes

Xero OAuth Scopes

OAuth 2.0 derived

Xero publishes 36 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Xero API on a user’s behalf.

Tokens are issued from https://identity.xero.com/connect/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

AccountingBank FeedsFinanceFinancial-ServicesInvoicingPayrollSmall Business
Scopes: 36 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://login.xero.com/identity/connect/authorize
Token URL
https://identity.xero.com/connect/token
Flows
authorizationCode

Scopes (36)

ScopeDescriptionFlows
accounting.attachments Grant read-write access to attachments authorizationCode
accounting.attachments.read Grant read-only access to attachments authorizationCode
accounting.budgets.read Grant read-only access to read budgets authorizationCode
accounting.contacts Grant read-write access to contacts and contact groups authorizationCode
accounting.contacts.read Grant read-only access to contacts and contact groups authorizationCode
accounting.journals.read Grant read-only access to journals authorizationCode
accounting.reports.read Grant read-only access to accounting reports authorizationCode
accounting.reports.tenninetynine.read Grant read-only access to 1099 reports authorizationCode
accounting.settings Grant read-write access to organisation and account settings authorizationCode
accounting.settings.read Grant read-only access to organisation and account settings authorizationCode
accounting.transactions Grant read-write access to bank transactions, credit notes, invoices, repeating invoices authorizationCode
accounting.transactions.read Grant read-only access to invoices authorizationCode
assets Grant read-write access to fixed assets authorizationCode
assets.read Grant read-only access to fixed assets authorizationCode
bankfeeds Grant read-write access to bankfeeds authorizationCode
email Grant read-only access to your email authorizationCode
files Grant read-write access to files and folders authorizationCode
files.read Grant read-only access to files and folders authorizationCode
finance.bankstatementsplus.read Grant read-only access to bank statements accounting data authorizationCode
finance.cashvalidation.read Grant read-only access to bank statement and reconcilation data authorizationCode
finance.statements.read Grant read-only access to finacial statements authorizationCode
openid Grant read-only access to your open id authorizationCode
paymentservices Grant read-write access to payment services authorizationCode
payroll.employees Grant read-write access to payroll employees authorizationCode
payroll.employees.read Grant read-only access to payroll employees authorizationCode
payroll.payruns Grant read-write access to payroll payruns authorizationCode
payroll.payruns.read Grant read-only access to payroll payruns authorizationCode
payroll.payslip Grant read-write access to payroll payslips authorizationCode
payroll.payslip.read Grant read-only access to payroll payslips authorizationCode
payroll.settings Grant read-write access to payroll settings authorizationCode
payroll.settings.read Grant read-only access to payroll settings authorizationCode
payroll.timesheets Grant read-write access to payroll timesheets authorizationCode
payroll.timesheets.read Grant read-only access to payroll timesheets authorizationCode
profile your profile information authorizationCode
projects Grant read-write access to projects authorizationCode
projects.read Grant read-only access to projects authorizationCode

📄 Provider scope reference:

Source

OAuth Scopes

Raw ↑ 
generated: '2026-07-11'
method: derived
source: openapi/xero-accounting-openapi.yml, openapi/xero-assets-openapi.yml, openapi/xero-bankfeeds-openapi.yml,
  openapi/xero-files-openapi.yml, openapi/xero-finance-openapi.yml, openapi/xero-identity-openapi.yml,
  openapi/xero-payroll-au-openapi.yml, openapi/xero-payroll-nz-openapi.yml, openapi/xero-payroll-uk-openapi.yml,
  openapi/xero-projects-openapi.yml
schemes:
- name: OAuth2
  source: openapi/xero-accounting-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information
- name: OAuth2
  source: openapi/xero-assets-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information
- name: OAuth2
  source: openapi/xero-bankfeeds-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information visit https://developer.xero.com/documentation/oauth2/overview
- name: OAuth2
  source: openapi/xero-files-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information
- name: OAuth2
  source: openapi/xero-finance-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information
- name: OAuth2
  source: openapi/xero-identity-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information
- name: OAuth2
  source: openapi/xero-payroll-au-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information visit https://developer.xero.com/documentation/oauth2/overview
- name: OAuth2
  source: openapi/xero-payroll-nz-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information visit https://developer.xero.com/documentation/oauth2/overview
- name: OAuth2
  source: openapi/xero-payroll-uk-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information visit https://developer.xero.com/documentation/oauth2/overview
- name: OAuth2
  source: openapi/xero-projects-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://login.xero.com/identity/connect/authorize
    tokenUrl: https://identity.xero.com/connect/token
  description: For more information
scopes:
- scope: accounting.attachments
  description: Grant read-write access to attachments
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.attachments.read
  description: Grant read-only access to attachments
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.budgets.read
  description: Grant read-only access to read budgets
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.contacts
  description: Grant read-write access to contacts and contact groups
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.contacts.read
  description: Grant read-only access to contacts and contact groups
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.journals.read
  description: Grant read-only access to journals
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.reports.read
  description: Grant read-only access to accounting reports
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.reports.tenninetynine.read
  description: Grant read-only access to 1099 reports
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.settings
  description: Grant read-write access to organisation and account settings
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.settings.read
  description: Grant read-only access to organisation and account settings
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.transactions
  description: Grant read-write access to bank transactions, credit notes, invoices, repeating
    invoices
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: accounting.transactions.read
  description: Grant read-only access to invoices
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: assets
  description: Grant read-write access to fixed assets
  flows:
  - authorizationCode
  sources:
  - openapi/xero-assets-openapi.yml
- scope: assets.read
  description: Grant read-only access to fixed assets
  flows:
  - authorizationCode
  sources:
  - openapi/xero-assets-openapi.yml
- scope: bankfeeds
  description: Grant read-write access to bankfeeds
  flows:
  - authorizationCode
  sources:
  - openapi/xero-bankfeeds-openapi.yml
- scope: email
  description: Grant read-only access to your email
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
  - openapi/xero-assets-openapi.yml
  - openapi/xero-bankfeeds-openapi.yml
  - openapi/xero-files-openapi.yml
  - openapi/xero-finance-openapi.yml
  - openapi/xero-identity-openapi.yml
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-projects-openapi.yml
- scope: files
  description: Grant read-write access to files and folders
  flows:
  - authorizationCode
  sources:
  - openapi/xero-files-openapi.yml
- scope: files.read
  description: Grant read-only access to files and folders
  flows:
  - authorizationCode
  sources:
  - openapi/xero-files-openapi.yml
- scope: finance.bankstatementsplus.read
  description: Grant read-only access to bank statements accounting data
  flows:
  - authorizationCode
  sources:
  - openapi/xero-finance-openapi.yml
- scope: finance.cashvalidation.read
  description: Grant read-only access to bank statement and reconcilation data
  flows:
  - authorizationCode
  sources:
  - openapi/xero-finance-openapi.yml
- scope: finance.statements.read
  description: Grant read-only access to finacial statements
  flows:
  - authorizationCode
  sources:
  - openapi/xero-finance-openapi.yml
- scope: openid
  description: Grant read-only access to your open id
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
  - openapi/xero-assets-openapi.yml
  - openapi/xero-bankfeeds-openapi.yml
  - openapi/xero-files-openapi.yml
  - openapi/xero-finance-openapi.yml
  - openapi/xero-identity-openapi.yml
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-projects-openapi.yml
- scope: paymentservices
  description: Grant read-write access to payment services
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
- scope: payroll.employees
  description: Grant read-write access to payroll employees
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: payroll.employees.read
  description: Grant read-only access to payroll employees
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: payroll.payruns
  description: Grant read-write access to payroll payruns
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: payroll.payruns.read
  description: Grant read-only access to payroll payruns
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: payroll.payslip
  description: Grant read-write access to payroll payslips
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: payroll.payslip.read
  description: Grant read-only access to payroll payslips
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: payroll.settings
  description: Grant read-write access to payroll settings
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: payroll.settings.read
  description: Grant read-only access to payroll settings
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: payroll.timesheets
  description: Grant read-write access to payroll timesheets
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: payroll.timesheets.read
  description: Grant read-only access to payroll timesheets
  flows:
  - authorizationCode
  sources:
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-payroll-nz-openapi.yml
  - openapi/xero-payroll-uk-openapi.yml
- scope: profile
  description: your profile information
  flows:
  - authorizationCode
  sources:
  - openapi/xero-accounting-openapi.yml
  - openapi/xero-assets-openapi.yml
  - openapi/xero-bankfeeds-openapi.yml
  - openapi/xero-files-openapi.yml
  - openapi/xero-finance-openapi.yml
  - openapi/xero-identity-openapi.yml
  - openapi/xero-payroll-au-openapi.yml
  - openapi/xero-projects-openapi.yml
- scope: projects
  description: Grant read-write access to projects
  flows:
  - authorizationCode
  sources:
  - openapi/xero-projects-openapi.yml
- scope: projects.read
  description: Grant read-only access to projects
  flows:
  - authorizationCode
  sources:
  - openapi/xero-projects-openapi.yml

Work with this as data

Every scope set here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for oauth scopes

4 MCP tools reach this
  • find_scopesBrowse and filter every scope set in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This scope set 
curl "https://apis.io/api/v1/scopes/xero-scopes"
All oauth scopes 
curl "https://apis.io/api/v1/scopes?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.