Jobspipe Webhooks

generated: '2026-10-29'
method: searched
generator: extract-docs-artifacts.py (local)
source: https://docs.jobspipe.dev/api-reference/webhooks
sources:
- https://docs.jobspipe.dev/api-reference/webhooks
description: JobsPipe provides webhooks for job closure events and Signal match events.
events:
- event: job.closed
  description: 'Fires when a job in one of your monitors closes (only verified closes: "gone" or "closed"). A webhook endpoint receives a signed
    JSON payload containing the closed job details; the same payload is sent unchanged on retries.'
- event: alert.matched
  description: Fires when a Signal with a webhook destination finds new matches; deliveries occur instantly for instant destinations or once per
    day for daily‑digest destinations. Each delivery is signed with the Signal’s unique HMAC‑SHA256 secret.
- event: alert.test
  description: Sent when a Signal webhook destination is created; it is a signed test delivery with an empty data array, used to verify the URL
    immediately. Test deliveries are not retried.
delivery:
  auth: HMAC‑SHA256 verification using a signing secret that starts with "whsec_"; the secret is provided once when the endpoint or Signal is
    created.
  signature: The secret is used to compute an HMAC‑SHA256 signature of the request body (the exact header name is not specified in the documentation).
  retries: Webhooks are best‑effort; failed deliveries are retried with the original payload unchanged. The exact retry schedule is not detailed
    in the documentation.
docs: https://docs.jobspipe.dev/api-reference/webhooks