Let User Events In
When the address is on this endpoint and the endpoint asks people to sign in, list the address's path as open for POST with the ngris-events signature check: ngris checks each event's signature with this endpoint's secret before it reaches your app, and anyone else on that path still has to sign in. Answers 200 when the events get through already.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.Response (201 Created)
The webhook and its state, receiver.let_in now true. The path shows in GET .../access-paths.
Errors
401 Unauthorized
Missing auth.
403 Forbidden
Your role lacks
endpoints:update in the active account, or your plan doesn't have user events ("code": "entitlement_required", "entitlement_required": "endpoint_user_events").404 Not Found
No such endpoint, or it has no user-events webhook.
409 Conflict
The address isn't on this endpoint (check the signature in your app there); the endpoint doesn't ask people to sign in (the events get through already); the path skips sign-in already without a check; or the path can't be listed.
Request
curl -X POST "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/user-events/path" \
-H "X-API-KEY: <your_api_key>"
CLI
ngris api endpoint-user-events let-in 019bb1e4-e785-77d2-9966-c3cff31d0a0e --yes
Response — 201 Created
{
"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": true,
"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?