​
Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

​
Pre-built tooling

​
Pre-built integrations

Not seeing the integration you need? Build your own independently.

​
Access requirements

Pre-RequisitesStatusComment
Paid dev account✅ Not requiredFree, self-signup for a Xero Developer account.
Paid test account✅ Not requiredDeveloper account includes a demo company for testing.
Partnership✅ Not required
App review✅ Not requiredOnly required for apps published to the Xero App Store.
Security audit✅ Not required

​
Setup guide

1

Create a Xero Developer account

Go to Xero Developer signup page and create a free account.

2

Create a new app

  1. Log in to your Xero My Apps developer console.
  2. Click New app in the top right corner.
  3. A new app form will appear. Enter a unique App name.
  4. Select Mobile or desktop app as the integration type.
  5. Fill in the Company or application URL and Redirect URI fields. For the Redirect URI, use: https://api.nango.dev/oauth/callback.
  6. Check the developer’s terms checkbox and click Create App.
  7. Your app will be generated, and you will be redirected to your App details page.
3

Obtain API credentials

  1. Navigate to the Configuration tab to retrieve your Client ID and Client Secret.
  2. Click Generate a Secret to create a new Client Secret.
  3. You will need these credentials when configuring your integration in Nango.
4

Next

Follow the Quickstart.

Need help getting started? Get help in the community.
Contribute improvements to the setup guide by editing this page
TopicLinks
GeneralWebsite
Create a Developer account
Developer Dashboard
DeveloperAPI documentation
Authentication documentation
OAuth 2.0 authorization flow
Register an application
List of OAuth scopes
API rate limits
Contribute useful links by editing this page

​
API gotchas

  • When a user authorizes your app, they select which Xero organization to connect. Your app can only access data for the selected organization.
  • If you need to work with multiple Xero organizations, you’ll need to handle the tenant context in your API calls. After a connection is created, Nango will automatically fetch and store the tenant_id in the connection config, which you can then use in your API calls.
  • Make sure you add the offline_access scope to ensure the token refreshes as expected
Contribute API gotchas by editing this page
Suggest editsRaise issue