Permission webhook

The Permission 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: PERMISSION

Supported events:

  • CREATE
  • UPDATE
  • DELETE

Summary

Webhook for updates related to permission grants

Description

Listen for updates to the permissions in order to validate that grants are compliant. Baack uses fine grained permissions so permissions can be granted in a very scoped manner however changes often need to be audited. By listening to permission updates your integration can verify the integrity of your permission sets.

Permissions are often assigned at an owning company level which is inherited to child concepts.

See permission roles for creating role based permission sets.

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" : "PERMISSION",
    "event" : "CREATE",
    "targetUrn" : "fdcb0191-8408-4132-abf7-57adeafe59e2"
  },
  "subscription" : {
    "urn" : "691be1de-09df-411d-ad4a-3cc7ec771cd4",
    "subject" : "PERMISSION",
    "event" : "ALL",
    "destinationUrl" : "https://example.com/webhooks/permission",
    "auth" : "BEARER",
    "expirationTimestamp" : "2026-06-28T13:45:32",
    "eventsPerMinute" : 500
  },
  "v1" : {
    "urn" : "fdcb0191-8408-4132-abf7-57adeafe59e2",
    "url" : "/n/v1/permission/fdcb0191-8408-4132-abf7-57adeafe59e2"
  }
}