How to configure Xero webhooks with Tenklo

Learn how to set up webhook notifications from Xero to Tenklo

This guide shows you how to configure webhooks from Xero to receive real-time notifications about changes in your users' Xero accounts.

Configuring Xero Webhooks

Get your Tenklo webhook URL

  1. Go to the Tenklo 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.tenklo.dev/webhook/<UUID>/xero)

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 Tenklo 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

Add webhook secret to Tenklo

  1. Return to the Tenklo 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

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.

On this page