Platform Guides
Notifications & Webhooks
Read in-app notifications and receive platform events at your own HTTP endpoints.
Overview
Notifications are messages delivered to users inside the platform. Webhooks push platform events — such as a completed training run — to an HTTP endpoint you control, so your systems react without polling.
Notifications
| GET | /api/v1/notifications | List notifications for the current user. |
| POST | /api/v1/notifications/{id}/read | Mark a notification as read. |
Webhooks
Register a webhook with a target URL and the events you want. The platform delivers a signed POST request for each matching event.
| GET | /api/v1/webhooks | List registered webhooks. |
| POST | /api/v1/webhooks | Register a webhook endpoint. |
| DELETE | /api/v1/webhooks/{id} | Remove a webhook. |
Verify every delivery
Webhook callbacks are authenticated with a shared secret, not a user token. Validate the signature header on each inbound request before acting on the payload, and respond with
2xx quickly — slow responses are retried.See the full schema and parameters in the Label Backend API reference.