Segments

Create a segment

Changed on

Create a segment from a filter expression. It starts empty until evaluated. Validate and preview the filter first.

post/api/v1/segments

Request

  • Base URL
    https://www.useboom.ai
  • Auth
    HTTP bearer

Request body

namestring required

Display name.

slugstring required

Permanent identifier, lowercase-kebab-case, unique in your organization. Cannot be changed after creation.

descriptionstring nullable
evaluationCadence'REACTIVE_ONLY' | 'HOURLY' | 'DAILY'

How often the segment re-evaluates. Defaults to REACTIVE_ONLY — evaluate on demand with segments_evaluate.

dailyEvaluationHourinteger nullable

For DAILY cadence: the hour (0-23, in your organization timezone) the segment evaluates.

skipWeekendEvaluationboolean

When true, the segment is not evaluated on weekends.

includeBoomCreatedboolean

When true, people Boom created for contacts who messaged you first (externalId boom:…) can match this segment. Defaults to false, or to true when the filter asks for them (identityOrigin MINTED). Boom enforces no marketing opt-in for them, so filter on consent yourself before marketing to them.

Response

Success

idstring required

Stable internal identifier. Pass this wherever a segment reference is stored — e.g. a journey trigger's segmentId.

slugstring required

Unique identifier within your organization.

namestring required
descriptionstring nullable required
evaluationCadence'REACTIVE_ONLY' | 'HOURLY' | 'DAILY' required

How often the segment is re-evaluated. REACTIVE_ONLY segments only change when evaluated explicitly.

memberCountinteger required

Live count of currently active members.

includeBoomCreatedboolean required

Whether people Boom created for contacts who messaged you first can match. False by default.

lastEvaluatedAtstring nullable required

ISO 8601 timestamp; null if the segment has never evaluated.

createdAtstring required

ISO 8601 timestamp.

warningsstring[]

Advice about the saved segment; the write succeeded.

newlyMatchingBoomCreatedinteger

Set when this update turned includeBoomCreated on: the people created by Boom who now match. They enter on the next evaluation; every journey this segment triggers starts for them, and every scheduled campaign that sends to it includes them.

Changes

    • breaking

      removed subschema #1 subschema #2 subschema #3 subschema #4 from the // request property oneOf list

    • info

      added the new optional request property

    • info

      added the new optional request property ///

    • info

      added the new optional request property ///

    • info

      added the new identityOrigin enum value to the request property ///

    • info

      added subschema #1 subschema #2 subschema #3 subschema #4 to the // request property oneOf list

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status