Webhooks

Rather than poll, subscribe to webhooks and Payloom tells you when something happens. Every delivery is signed, retried until it arrives, and repeatable for 90 days.

Events

These are the events Payloom actually sends today.

Event	When it fires
pay_run.calculated	The numbers are ready. Nothing has been paid yet.
pay_run.approved	A named person approved the run. It is now locked.
pay_run.paid	The run was marked paid.
pay_run.reopened	An approved run was reopened for a correction.
payslip.published	An employee can now see their payslip.
employee.created	A new employee was added.
employee.updated	An employee’s details changed.
employee.archived	An employee was archived.

Note

A run moving into calculating or falling back to draft sends nothing on purpose: integrators hear that a calculation is done (pay_run.calculated), not that one started.

Verifying a delivery

Each request carries a signature computed with your endpoint’s signing secret. Recompute it over the raw request body and compare, in constant time, before you trust the payload. Reject anything that does not match.

Retries

If your endpoint does not return a 2xx, Payloom retries on a backing-off schedule and keeps the delivery available to replay for 90 days, so a brief outage on your side never loses an event.