Delivery

Webhooks

PolDex sends signed webhook payloads to your webhook_url on job completion.

X-PolDex-Signature	Timestamped HMAC-SHA256 signature.
X-PolDex-Job-Id	The job ID.
X-PolDex-Delivery-Id	Unique delivery attempt ID.

Retries

Delivery is bounded to three signed attempts. Retryable failures return delivery metadata including attempt count, HTTP status when available, last error, and retryable state for replay/admin handling.

Test

POST /v1/webhook-test/send
curl -X POST https://poldex-api.plain-water-cd0f.workers.dev/v1/webhook-test/send \
  -H "x-api-key: pd_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"webhook_url":"https://your.app/webhook","event_type":"job.completed"}'