ConverterHQDevelopers
Documentation

Webhooks

Durable signed lifecycle notifications with retries and replay.

Webhooks are the durable push mechanism for asynchronous processing. Delivery is at-least-once, so handlers should be idempotent by event ID.

Subscribe to events

Filter endpoints to events such as job.succeeded, job.failed or task lifecycle events. Empty filters may subscribe to the supported event set.

Verify signatures

ConverterHQ-Signature includes a timestamp and HMAC-SHA256 signature over timestamp.raw_body. Official SDKs validate both signature and replay tolerance.

import os
from converterhq import verify_webhook

event = verify_webhook(request.body, request.headers["ConverterHQ-Signature"], os.environ["CONVERTERHQ_WEBHOOK_SECRET"])

Retries and replay

Failed deliveries are retried with jittered backoff and remain visible in the delivery console with request, response, latency and next retry. You can replay a stored event manually.