Get User Events

GET /v1/endpoints/{uuid}/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?
On this page
Get User Events
Was this helpful?