{
"id": "wh_evt_67aa128c2f4a",
"event": "user_role.created",
"api_version": "2024-01",
"created": 1735689600,
"tenant_id": 1,
"request": {
"id": "req_8c2f4a67aa12"
},
"object": {
"@id": "/api/v1/user_roles/199",
"id": 199,
"user": {
"@id": "/api/v1/users/42",
"id": 42,
"fullName": "James Patterson"
},
"role": {
"@id": "/api/v1/roles/12",
"id": 12,
"name": "Chapter Lead"
},
"unit": {
"@id": "/api/v1/units/4",
"id": 4,
"name": "Boston"
},
"dateCreated": "2026-01-15T10:30:00+00:00"
},
"previous_attributes": null,
"is_update": false,
"entity_type": "user_role",
"operation": "created"
}Role assigned to a user
Fires when a User is granted a role on a Unit — promotion to chapter lead, treasurer assignment, etc. Useful for sync to external permission systems (Slack channels, GitHub teams).
{
"id": "wh_evt_67aa128c2f4a",
"event": "user_role.created",
"api_version": "2024-01",
"created": 1735689600,
"tenant_id": 1,
"request": {
"id": "req_8c2f4a67aa12"
},
"object": {
"@id": "/api/v1/user_roles/199",
"id": 199,
"user": {
"@id": "/api/v1/users/42",
"id": 42,
"fullName": "James Patterson"
},
"role": {
"@id": "/api/v1/roles/12",
"id": 12,
"name": "Chapter Lead"
},
"unit": {
"@id": "/api/v1/units/4",
"id": 4,
"name": "Boston"
},
"dateCreated": "2026-01-15T10:30:00+00:00"
},
"previous_attributes": null,
"is_update": false,
"entity_type": "user_role",
"operation": "created"
}Authorizations
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Body
Unique delivery identifier — log this to correlate with Orgo's delivery dashboard.
"wh_evt_67aa128c2f4a"
The event type — e.g. user.created, product_payment.updated.
user_role.created "user_role.created"
Webhook payload schema version.
"2024-01"
Unix timestamp (seconds) of when the delivery was sent.
1735689600
ID of the Orgo tenant the event belongs to. Use this to route deliveries in a multi-tenant receiver.
1
Snapshot of the entity at the moment the event was emitted.
{
"@id": "/api/v1/user_roles/199",
"id": 199,
"user": {
"@id": "/api/v1/users/42",
"id": 42,
"fullName": "James Patterson"
},
"role": {
"@id": "/api/v1/roles/12",
"id": 12,
"name": "Chapter Lead"
},
"unit": {
"@id": "/api/v1/units/4",
"id": 4,
"name": "Boston"
},
"dateCreated": "2026-01-15T10:30:00+00:00"
}
Metadata about the API request that triggered the event (when applicable).
Show child attributes
Show child attributes
True for *.updated events, false otherwise.
false
The entity family — e.g. user, product_payment, contact.
"user"
The operation — created, updated, or deleted.
created, updated, deleted Diff against the prior state. Only fields that changed are present. null for created/deleted events.
null
Response
Acknowledged. Any 2xx tells Orgo the delivery succeeded.