Docs
Webhooks
Set a default webhook URL in the console (Settings), or pass webhook_url per job. We POST:
{ "type": "transcription.job.completed", "data": { "job": { "id": "trj_…", "status": "completed", "units": "2730.000" } } }
Types: transcription.job.completed, transcription.job.failed.
Verify the signature
Every delivery carries Pool-Signature: t=<unix seconds>,v1=<hex>. Compute HMAC-SHA256(secret, "<t>.<raw body>") with your webhook secret and compare in constant time. Reject timestamps older than 5 minutes.
import hmac, hashlib, time
def verify(secret: bytes, header: str, body: bytes) -> bool:
parts = dict(p.split("=", 1) for p in header.split(","))
if abs(time.time() - int(parts["t"])) > 300:
return False
mac = hmac.new(secret, f"{parts['t']}.".encode() + body, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, parts["v1"])
Deliveries are retried for up to 24 hours. The URL must be public https (same rules as job URLs).