Docs

Webhooks: automate validation and monitoring events.

Use signed WillItInbox webhooks for bulk job completion, test delivery, resend workflows, and future monitoring events.

Webhook events

Webhooks are designed for workflows where polling is not ideal. Bulk completion is the first stable use case, with monitoring and alert events following the same signed delivery model.

  • Create persistent endpoints with event subscriptions.
  • Send test payloads before relying on production events.
  • Inspect delivery attempts and resend persistent endpoint deliveries.

Security model

WillItInbox signs webhook payloads with HMAC SHA-256 so receivers can verify that an event came from the platform and was not modified in transit.

  • Verify the X-WillItInbox-Signature header.
  • Reject events with unexpected timestamps or unknown endpoints.
  • Log delivery failures and retry through the API when needed.