Person webhook

The Person 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_PERSON

Supported events:

  • CREATE
  • UPDATE
  • DELETE

Summary

Webhook events for updates to a person associated with an identity.

Description

Listen to person creation events to know when an individual person is created for an identity. The person also holds the gender and date of birth.

Note that a person can have multiple names using the person name representation and if listening to the person creation event the webhook may be triggered before the name is created.

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