The Email 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_EMAIL_ADDRESS
Supported events:
Webhook for events related to identity email addresses
Listen to email events to drive rich engagements both internally and externally like creating a custom workflow to verify an email address.
Email addresses are also used for notifications in membership groups so adding a new email address to an identity may also trigger activities like an email verification process via a third party service.
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_EMAIL_ADDRESS",
"event" : "CREATE",
"targetUrn" : "fdcb0191-8408-4132-abf7-57adeafe59e2"
},
"subscription" : {
"urn" : "691be1de-09df-411d-ad4a-3cc7ec771cd4",
"subject" : "IDENTITY_EMAIL_ADDRESS",
"event" : "ALL",
"destinationUrl" : "https://example.com/webhooks/email",
"auth" : "BEARER",
"expirationTimestamp" : "2026-06-28T13:45:32",
"eventsPerMinute" : 500
},
"v1" : {
"urn" : "fdcb0191-8408-4132-abf7-57adeafe59e2",
"url" : "/n/v1/email/fdcb0191-8408-4132-abf7-57adeafe59e2"
}
}