Get User Events
The endpoint's user-events webhook: the address (shortened: it may carry a token), the events it sends, whether it is active or paused (after 5 days in which every delivery failed), its last delivery, and, when the address is on this endpoint, whether this endpoint's sign-in lets the events in (receiver; its path shows to those who can change the endpoint, and to everyone once it is let in). webhook is null when none is set up; available says whether your plan has user events. The signing secret is never in this answer.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.Response (200 OK)
The webhook and its state.
Errors
401 Unauthorized
Missing auth.
403 Forbidden
Your role lacks
endpoints:read in the active account.404 Not Found
No such endpoint in your active account.
503 Service Unavailable
User events aren't available yet. Try again in a few minutes.
Request
curl "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/user-events" \
-H "X-API-KEY: <your_api_key>"
CLI
ngris api endpoint-user-events show 019bb1e4-e785-77d2-9966-c3cff31d0a0e
Response — 200 OK
{
"endpoint_id": "019bb1e4-e785-77d2-9966-c3cff31d0a0e",
"available": true,
"webhook": {
"url": "https://…acme.com/…",
"events": [
"user.created",
"user.updated",
"user.deactivated",
"user.deleted",
"user.roles_changed"
],
"status": "active",
"paused_at": null,
"failing_since": null,
"last_success_at": "2026-11-19T15:41:02Z",
"created_at": "2026-11-19T14:02:11Z",
"updated_at": "2026-11-19T14:02:11Z"
},
"receiver": {
"on_this_endpoint": true,
"sign_in_on": true,
"path": "/hooks/ngris",
"let_in": false,
"open": false
},
"event_types": [
"user.created",
"user.updated",
"user.deactivated",
"user.deleted",
"user.roles_changed",
"user.signed_in"
],
"default_events": [
"user.created",
"user.updated",
"user.deactivated",
"user.deleted",
"user.roles_changed"
]
}
Was this helpful?