{
"success": false,
"event": "PDF_GENERATION_FAILED",
"requestId": "req_123",
"mode": "async",
"errorCode": "500",
"subCode": "PDF_GENERATION_FAILED",
"message": "PDF generation failed",
"details": "Template compilation error",
"meta": {
"issues": []
},
"timestamp": "2025-09-14T12:34:56Z"
}Endpoints
pdf.failed
We POST this event to your endpoint if PDF generation fails in async mode. Your endpoint must return a 2xx response within 10 seconds. Use the svix-id, svix-timestamp, and svix-signature headers to verify authenticity with your Svix signing secret.
WEBHOOK
pdf.failed
{
"success": false,
"event": "PDF_GENERATION_FAILED",
"requestId": "req_123",
"mode": "async",
"errorCode": "500",
"subCode": "PDF_GENERATION_FAILED",
"message": "PDF generation failed",
"details": "Template compilation error",
"meta": {
"issues": []
},
"timestamp": "2025-09-14T12:34:56Z"
}Authorizations
Headers
Unique message identifier; constant on retries.
UNIX timestamp (seconds) when the webhook was sent.
Pattern:
^[0-9]+$HMAC-SHA256 signature(s) over "{id}.{timestamp}.{payload}". Format: space-delimited list of "v,<base64_signature>" (e.g. "v1,abc...").
Body
application/json
Example:
false
Available options:
PDF_GENERATION_FAILED Correlation ID from original request
Available options:
async Maps to HTTP status code class
Available options:
500 Specific error subcode
Example:
"PDF_GENERATION_FAILED"
Human-readable error message
Optional extra debug info
Optional structured data
Example:
{
"requiredCredits": 1,
"availableCredits": 0,
"issues": []
}
Response
200
Receipt acknowledged
⌘I