Segment build failed

POST

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.

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

Canonical envelope posted to your webhook when an async segment build fails due to an enrichment or workflow error.

object

id

required

string

type

required

string

Allowed values: segment.failed

created_at

required

string format: date-time

api_version

required

string

org_id

required

string

subject

required

Identifies the segment this event is about.

object

kind

required

string

Allowed values: segment

id

required

string

name

required

string | null

data

required

status is always present; the remaining fields vary by failure path — treat any field not listed here as additive.

object

status

required

string

Allowed values: failed

failure_reason

Human-readable explanation of the failure.

string

audience_id

Audience wrapper ID if one was created alongside the segment.

string | null

key

additional properties

any

links

required

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

object

key

additional properties

any

Example

{
  "id": "evt_2b3c4d5e6f7a8b9c0d1e2f1a",
  "type": "segment.failed",
  "created_at": "2026-08-26T18:04:12.000Z",
  "api_version": "2026-08-06",
  "org_id": "org_xyz",
  "subject": {
    "kind": "segment",
    "id": "seg_abc123",
    "name": "High-Value Purchasers"
  },
  "data": {
    "status": "failed",
    "failure_reason": "No usable identity columns found in uploaded file."
  },
  "links": {}
}

Responses

200

Your endpoint acknowledged the event.