Reference

Event catalogue

62 events, each with the capability a key needs to subscribe and the fields its payload carries. Payloads are identifiers, states and timestamps only — no names, titles or free text — so read the details you need through the API with the ids you receive. That is a privacy rule, not a style choice: the event log is outside the reach of anonymisation.

Machine-readable

The same catalogue is served as JSON Schema (draft 2020-12), so you can generate types and validate deliveries instead of trusting this table.

curl https://api.kelomo.fi/v1/webhook-events \
  -H "Authorization: Bearer kelomo_…"

# → { "events": [ { "event": "workday.approved",
#                   "capabilities": ["worktime.supervise"],
#                   "payloadSchema": { "$schema": "…draft/2020-12/schema", … } } ] }

Subscribe with POST /v1/webhooks. Subscribing to an event also requires the capability that guards it — a key that cannot see payroll data cannot receive payroll events either.

The events