Skip to main content

Webhooks

Aient webhooks deliver tenant-selectable events as CloudEvents 1.0 structured JSON. Each event page includes the immutable schema URL, topic, source template, subject template, payload fields, and an example CloudEvent.

Delivery semantics

ContractBehavior
EncodingCloudEvents 1.0 structured JSON
DeliveryAt least once
OrderingNot globally ordered; use event timestamps and IDs
IdempotencyUse the CloudEvents (source, id) tuple as the event identity
CompatibilityAdditive schema changes are preferred; removed fields require a new event version
Validate type, verify signatures, process idempotently, and return a 2xx response only after durable acceptance.