Person Name webhook

The Person Name 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_NAME

Supported events:

• CREATE
• UPDATE
• DELETE

Summary

Webhook for events related to associating a person a name

Description

Listen to person name events for changes like additions of a new alias or creation of an identity with a name in order to trigger custom experiences like welcoming a person as a customer.

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