Hollyhr Com Webhooks

generated: '2026-11-11'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://developers.hollyhr.com/webhooks
sources:
- https://developers.hollyhr.com/webhooks
- https://developers.hollyhr.com/node-webhook-receiver
- https://developers.hollyhr.com/create-person-webhook
- https://developers.hollyhr.com/webhook-payroll-references
description: HollyHR publishes webhook events for changes made through the public API write surface and some in‑app mutations.
events:
- event: person.created
  description: Occurs when a new person record is created.
- event: person.updated
  description: Occurs when an existing person record is updated.
- event: person.ended
  description: Occurs when a person’s employment is ended.
- event: person.reactivated
  description: Occurs when a previously ended person is re‑activated.
- event: time_off.created
  description: Occurs when a time‑off request is created.
- event: time_off.updated
  description: Occurs when a time‑off request is updated.
- event: time_off.approved
  description: Occurs when a time‑off request is approved.
- event: time_off.declined
  description: Occurs when a time‑off request is declined.
- event: time_off.cancelled
  description: Occurs when a time‑off request is cancelled.
- event: time_off_category.created
  description: Occurs when a time‑off category is created.
- event: time_off_category.updated
  description: Occurs when a time‑off category is updated.
- event: time_off_category.archived
  description: Occurs when a time‑off category is archived.
- event: time_off_settings.updated
  description: Occurs when time‑off settings are updated.
- event: org_unit.created
  description: Occurs when an organisational unit is created.
- event: org_unit.updated
  description: Occurs when an organisational unit is updated.
- event: org_unit.archived
  description: Occurs when an organisational unit is archived.
- event: org_unit.reactivated
  description: Occurs when an archived organisational unit is re‑activated.
- event: working_pattern.created
  description: Occurs when a working‑pattern is created.
- event: working_pattern.updated
  description: Occurs when a working‑pattern is updated.
- event: working_pattern.archived
  description: Occurs when a working‑pattern is archived.
- event: webhook.test
  description: Synthetic test event used to verify webhook configuration.
delivery:
  signature: 'HollyHR signs the raw JSON request body with HMAC‑SHA256 over <unix_timestamp>.<raw_json_body> and sends the digest in the HollyHR-Webhook-Signature
    header (format: v1=<digest>[,v1=<previous-digest>]).'
  retries: Deliveries are at‑least‑once. Non‑2xx responses, timeouts, 408, 429, and 5xx responses are retried with bounded backoff. 4xx responses
    are considered non‑retryable and become failed deliveries.
note: Endpoint URLs must be public HTTPS. The signing secret is returned once when the webhook is created or rotated.
docs: https://developers.hollyhr.com/webhooks