​
Configuring Xero Webhooks

To receive webhooks from Xero, follow these steps:

1

Get your Nango webhook URL

  1. Go to the Nango UI and navigate to the Integrations tab
  2. Select your Xero integration
  3. Go to the Settings sub-tab
  4. Copy your unique webhook URL (it should look like https://api.nango.dev/webhook/<UUID>/xero)
2

Configure webhook in Xero

  1. Go to your Xero Developer Portal
  2. Select your app
  3. Navigate to the Webhooks tab
  4. Select the topics you would like to receive webhook notifications for
  5. Paste your Nango webhook URL from step 1 in the Deliver URL form
  6. Click Save to Save the configuration
  7. Copy the Webhook Key provided by Xero - you’ll need this in the next step
3

Add webhook secret to Nango

  1. Return to the Nango UI Settings page for your Xero integration
  2. In the Webhook Configuration section, paste the Xero Webhook Key into the Webhook Secret field
  3. Click Save
4

Verify the webhook

  1. In the Xero Developer Portal, click the Send intent to receive validation button
  2. If everything is configured correctly, you should see a successful validation response
  3. Your webhooks are now ready to receive events from Xero

​
Webhook Events

Once configured, you can receive webhook events from Xero such as:

  • Contact events (created, updated)
  • Invoice events (created, updated)

For a complete list of webhook events, refer to the Xero Webhook API documentation.

Need help getting started? Get help in the community.
Contribute improvements to this guide by editing this page