Sign in
latestOpenAPI 3.1.0Proprietary - Prezent, Inc.2026-08-114675175.5 KB

a01cb764a085

Webhooks

Test delivery

Sent once when you call the subscription test endpoint. Single-shot — delivered once with no retries — so you can verify connectivity and signature handling before production traffic flows.

postWebhookwebhook.test

Payload

idstring required

Globally unique event identifier. Also sent in the X-Prezent-Event header. Dedupe on this if you receive the same event twice (at-least-once delivery).

type'autogeneration.completed' | 'autogeneration.failed' | 'template_conversion.completed' | 'template_conversion.failed' | 'webhook.test' required

Catalog of event types emitted by Prezent. New types may be added without notice; clients should ignore unknown values.

api_versionstring required

Schema version for the data field. Increments only on breaking changes; legacy versions remain available.

created_atstring date-time required
dataobject required

Event-specific payload. For autogeneration.* events, contains callback_id, report_id, status, plus outputs (on success) or error_log (on failure). For template_conversion.* events, contains the conversion callback_id, status, and output URLs.

Example payload

{
  "id": "evt_8c2a1f7e6d3b4a5c9e0f8d7b6a5c4d3e",
  "api_version": "1.0"
}

Response

Acknowledged — any 2xx within 10 seconds.