The Group Membership 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: GROUP_MEMBERSHIP
Supported events:
Webhook for events related to membership of a group for an identity.
Group membership is managed by creating a group membership for a given identity. Group membership includes a rich model for membership notifications as well as a full lifecycle state which can be used to capture opt in as with mailing list groups. Group membership can also include negative states like banning a specific identity from the group.
Monitor group membership to enforce custom policy logic for group membership or monitoring changes like when an internal user accepts a group invitation.
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" : "GROUP_MEMBERSHIP",
"event" : "CREATE",
"targetUrn" : "fdcb0191-8408-4132-abf7-57adeafe59e2"
},
"subscription" : {
"urn" : "691be1de-09df-411d-ad4a-3cc7ec771cd4",
"subject" : "GROUP_MEMBERSHIP",
"event" : "ALL",
"destinationUrl" : "https://example.com/webhooks/groupmembership",
"auth" : "BEARER",
"expirationTimestamp" : "2026-06-28T13:45:32",
"eventsPerMinute" : 500
},
"v1" : {
"urn" : "fdcb0191-8408-4132-abf7-57adeafe59e2",
"url" : "/n/v1/groupmembership/fdcb0191-8408-4132-abf7-57adeafe59e2"
}
}