Webhooks

Set up webhooks

Prio tells your server when something changes for one of your users. Add your webhook URL on the Keys tab of your console; Prio shows the signing secret, whsec_…, once — store it with your API key.

What Prio sends

Event	data	When
user.status_changed	userId, status, previousStatus	a user’s approval status changed
invoice.created	the invoice	an invoice was made
invoice.updated	the invoice	an invoice’s status, amount, prices or due date changed

Request body

{
  "id": "msg_2d8f…",
  "event": "user.status_changed",
  "timestamp": "2026-09-28T16:04:11Z",
  "data": { … }
}

Answer quickly

Respond with any 2xx within 15 seconds, then do the work. Anything else — a timeout or a redirect included — counts as a failure and Prio tries again (Signatures and retries). The URL must be https, and Prio never follows a redirect.