---
title: "Changes to Create a segment"
method: POST
path: "/api/v1/segments"
---

# Changes to Create a segment

`POST /api/v1/segments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-11-03** `7c7a773b12ce`: 1 breaking, 9 info

## Changes

- **2026-11-03** `7c7a773b12ce`: 1 breaking, 9 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the `filterExpression/predicates/items/` request property `oneOf` list
  - added the new optional request property `includeBoomCreated`
  - added the new optional request property `outputColumns/customObjects/items/orderBy`
  - added the new optional request property `outputColumns/customObjects/items/path`
  - added the new `identityOrigin` enum value to the request property `outputColumns/person/columns/items/`
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `filterExpression/predicates/items/` request property `oneOf` list
  - added the optional property `newlyMatchingBoomCreated` to the response with the `201` status
  - added the optional property `warnings` to the response with the `201` status
  - added the required property `id` to the response with the `201` status
  - added the required property `includeBoomCreated` to the response with the `201` status

---

[Operation](https://skmtc.dev/useboom/apis/boom-api/docs/api/v1/segments/post.md) - [API](https://skmtc.dev/useboom/apis/boom-api.md) - [Page](https://skmtc.dev/useboom/apis/boom-api/changes/api/v1/segments/post)