Skip to main content
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions…
Dynamic Guide URL
Scopes Selected
Separator
You can only connect two uncertified apps to an organisation. You can disconnect by going to Connected apps in your Xero developer settings.


​
Register an OAuth Application
Register an application in the Xero Developer Portal to obtain OAuth credentials for API access.
1
Sign in to the Xero Developer Portal
Go to the Xero Developer Portal and click Log in in the top right corner. Sign in with your Xero account credentials.
2
Create a New App
Navigate to My Apps in the top navigation and click the New app button.
  • Enter your App name (e.g., StackOne Integration)
  • Select Web app as the Integration type
  • For the AI data usage question, select the appropriate option
  • Select Yes to confirm you agree to meet Xero’s minimum security requirements
  • Enter your Company or application URL
  • Set the OAuth 2.0 redirect URI to: https://api.stackone.com/connect/oauth2/xero/callback
  • Check the box to agree to the Xero Developer Platform Terms & Conditions
  • Click Create app
3
Copy Client Credentials
After creating the app, click Configuration in the left sidebar to obtain your credentials.
  • Click Copy next to the Client id to copy it
  • Click Generate a secret to create a new Client Secret
  • Copy the Client Secret immediately — it is only shown once
  • Store both values securely for use later


​
Configure Scopes
Select the OAuth scopes based on your integration needs. Scopes control which Xero data your application can access.
1
Select Permissions
Enables actions: Create Account, Create Bank Transaction, Create Contact, Create Credit Note, Create Invoice, Create Item, Create Manual Journal, Create Payment, Create Purchase Order, Create Quote, Create Tracking Category, Create Tracking Option, Delete Account, Delete Bank Transaction, Delete Item, Delete Payment, Delete Tracking Category, Delete Tracking Option, Get Account, Get Aged Payables, Get Aged Receivables, Get Balance Sheet, Get Bank Summary, Get Bank Transaction, Get Branding Theme, Get Budget Summary, Get Contact, Get Credit Note, Get Executive Summary, Get Invoice, Get Item, Get Manual Journal, Get Online Invoice URL, Get Organisation, Get Payment, Get Profit And Loss, Get Purchase Order, Get Quote, Get Tax Rate, Get Tracking Category, Get Trial Balance, Get User, List Accounts, List Bank Transactions, List Branding Themes, List Companies, List Contacts, List Credit Notes, List Invoices, List Items, List Manual Journals, List Payments, List Purchase Orders, List Quotes, List Tax Rates, List Tracking Categories, List Users, Update Account, Update Bank Transaction, Update Contact, Update Credit Note, Update Invoice, Update Item, Update Manual Journal, Update Purchase Order, Update Quote, Update Tracking Category, Update Tracking Option
Enable the scopes required for your use case. If no scopes are specified during connection, the default scopes will be used.


​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Xero:

1
Navigate to Connector Profiles
Login to StackOne and navigate to Connector Profiles
2
Create New Connector Profile
  • Click + Connector Profile
  • Search for and select Xero
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Xero.