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.