Skip to content
Webhooks

Get told when a render is done.

Register a URL per event type. Retries back off automatically if your endpoint is briefly down.

Events

  • render.completedA single render finished. Payload includes the signed URL.
  • render.failedA render failed. Payload includes the template line that broke.
  • batch.completedEvery document in a batch finished, successfully or not.
  • batch.progressSent every 10% through a large batch, for a progress bar.

Payload

Every event ships the same envelope:

{
  "event": "render.completed",
  "id": "rnd_8fk21",
  "data": { url, pages, expires_in },
  "sent_at": "2026-08-17T10:04:12Z"
}

Verifying signatures

Every request carries an X-Pagemint-Signatureheader — an HMAC-SHA256 of the raw request body, keyed with your webhook signing secret. Recompute it and compare before trusting the payload; a mismatch means the request didn't come from Pagemint.

Set up your first webhook

Open the dashboard ›API reference