Skip to main content

Update Webhook Settings

PATCH 
/api/xero/webhook-settings/:integrationInstanceId

Enable or disable Xero webhooks and update the signing key. Key rotation is supported with a 1-hour grace period for the previous key.

Authentication: Requires Bearer token.

Fields:

  • webhook_enabled (required, boolean): Enable or disable webhook processing
  • signing_key (optional, string, min 32 max 256): HMAC-SHA256 signing key from Xero

Errors:

  • 422: Cannot enable webhooks without a signing key

Request​

Responses​

Successful response