Webhooks

Segment build failed

POSTed to your webhook URL when an async segment build fails due to an enrichment or workflow error. See the Webhooks tag for the envelope shape and signing scheme.

postWebhooksegment.failed

Payload

idstring required
type'segment.failed' required
created_atstring date-time required
api_versionstring required
org_idstring required
linksobject required

Reserved for future related-resource links. Currently always empty.

Example payload

{
  "id": "evt_1a2b3c4d5e6f7a8b9c0d1e2f",
  "api_version": "2026-08-06"
}

Response

Your endpoint acknowledged the event.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.