Webhook Subscription webhook

The Webhook Subscription webhook is described below. Note that webhooks deliver only the event notification. The actual data must be read using the provided event details.

Webhook Subject: WEBHOOK_SUBSCRIPTION

Supported events:

  • CREATE
  • UPDATE
  • DELETE

Summary

Webhook for listening updates related to webhook subscriptions for your company.

Description

Notification events for webhook subscription updates for your company account.

Updates to webhooks can be critical to your integration so it is strongly encouraged to integrate these as subscriptions being revoked can result in loss of functionality.

Note that when a webhook is disabled its expiration timestamp will be set to 'now' to disable the subscription.

Example

Below is an example webhook payload (pretty printed):

{
  "trigger" : {
    "urn" : "6099cb4a-00a5-4e08-8a8d-c570254b5757",
    "owner" : {
      "urn" : "32a90f18-aaa0-4bdc-a63e-4efd2e16c28c",
      "url" : "/n/v1/company/32a90f18-aaa0-4bdc-a63e-4efd2e16c28c"
    },
    "timestamp" : "2026-05-29T13:45:32",
    "subject" : "WEBHOOK_SUBSCRIPTION",
    "event" : "CREATE",
    "targetUrn" : "fdcb0191-8408-4132-abf7-57adeafe59e2"
  },
  "subscription" : {
    "urn" : "691be1de-09df-411d-ad4a-3cc7ec771cd4",
    "subject" : "WEBHOOK_SUBSCRIPTION",
    "event" : "ALL",
    "destinationUrl" : "https://example.com/webhooks/webhooksubscription",
    "auth" : "BEARER",
    "expirationTimestamp" : "2026-06-28T13:45:32",
    "eventsPerMinute" : 500
  },
  "v1" : {
    "urn" : "fdcb0191-8408-4132-abf7-57adeafe59e2",
    "url" : "/n/v1/webhooksubscription/fdcb0191-8408-4132-abf7-57adeafe59e2"
  }
}