{
"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"
}Webhooks
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).
WEBHOOK
user_role.created
{
"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
ApiTokenJWT
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
application/json
Snapshot of the entity at the moment the event was emitted.
Example:
{
"@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"
}
Response
Acknowledged. Any 2xx tells Orgo the delivery succeeded.

