Identity webhook

The Identity 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: IDENTITY

Supported events:

  • CREATE
  • UPDATE
  • DELETE

Summary

Webhook for identity events to listen for updates to identities on the platform.

Description

Listen to the identity webhook event to be notified when a new identity is added on the platform.Identities aren't always people and because of the way that a 'person' identity is associated after the identity is created, when reading the identity, associated personal details may not have been created when the identity webhook is sent.

It is strongly recommended to use the identity deletion event as a trigger for activities related to data retention compliance if your integration has other records of personal information.Handling deletion of data successfully is a business critical compliance need so should be integrated early.Effective handling of data deletions can also be a key differentiator as it is for Baack.

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