Segment build failed

POST

POSTed to your webhook URL when an async segment build fails due to an enrichment or workflow error.

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

Posted to your webhook_url when segment creation fails due to an enrichment or workflow error.

object

event

required

string

Allowed values: segment.failed

segment_id

required

string

audience_id

Audience wrapper ID if one was created alongside the segment.

string | null

org_id

required

string

status

required

string

Allowed values: failed

subtype

string

Allowed values: matched similarity propensity

failure_reason

Human-readable explanation of the failure.

string

Example

{
  "event": "segment.failed",
  "segment_id": "seg_abc123",
  "audience_id": "aud_abc123",
  "org_id": "org_xyz",
  "status": "failed",
  "failure_reason": "No usable identity columns found in uploaded file."
}

Responses

200

Your endpoint acknowledged the event.