---
title: "Changes to Create Segment"
method: POST
path: "/v1/products/{productId}/segments"
---

# Changes to Create Segment

`POST /v1/products/{productId}/segments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 16 revisions.

- **2026-06-08** `fc2e575e2bd3`: 1 info
- **2025-10-09** `8b8a102e5ed1`: 6 info
- **2025-05-16** `2949501eef38`: 15 info
- **2024-05-18** `f14408c16a8c`: 10 breaking, 1 info

## Changes

- **2026-06-08** `fc2e575e2bd3`: 1 info
  - added the required property `product/approveRequired` to the response with the `201` status
- **2025-10-09** `8b8a102e5ed1`: 6 info
  - the response property `creatorEmail` became required for the status `201`
  - the response property `creatorFullName` became required for the status `201`
  - the response property `description` became required for the status `201`
  - the response property `lastUpdaterEmail` became required for the status `201`
  - the response property `lastUpdaterFullName` became required for the status `201`
  - the response property `product/description` became required for the status `201`
- **2025-05-16** `2949501eef38`: 15 info
  - the response property `comparator` became required for the status `201`
  - the response property `comparisonAttribute` became required for the status `201`
  - the response property `comparisonValue` became required for the status `201`
  - the response property `createdAt` became required for the status `201`
  - the response property `name` became required for the status `201`
  - the response property `product` became required for the status `201`
  - the response property `product/name` became required for the status `201`
  - the response property `product/order` became required for the status `201`
  - the response property `product/organization` became required for the status `201`
  - the response property `product/organization/name` became required for the status `201`
  - the response property `product/organization/organizationId` became required for the status `201`
  - the response property `product/productId` became required for the status `201`
  - the response property `product/reasonRequired` became required for the status `201`
  - the response property `segmentId` became required for the status `201`
  - the response property `updatedAt` became required for the status `201`
- **2024-05-18** `f14408c16a8c`: 10 breaking, 1 info
  - the `comparisonAttribute` request property's minLength was increased from `0` to `1` (media type: application/json)
  - the `comparisonAttribute` request property's minLength was increased from `0` to `1` (media type: text/json)
  - the `comparisonAttribute` request property's minLength was increased from `0` to `1` (media type: application/*+json)
  - the `comparisonValue` request property's minLength was increased from `0` to `1` (media type: application/json)
  - the `comparisonValue` request property's minLength was increased from `0` to `1` (media type: text/json)
  - the `comparisonValue` request property's minLength was increased from `0` to `1` (media type: application/*+json)
  - the `name` request property's minLength was increased from `0` to `1` (media type: application/json)
  - the `name` request property's minLength was increased from `0` to `1` (media type: text/json)
  - the `name` request property's minLength was increased from `0` to `1` (media type: application/*+json)
  - removed the media type `application/hal+json` for the response with the status `201`
  - removed the non-success response with the status `401`

---

[Operation](https://skmtc.dev/configcat/apis/configcat-public-management-api/docs/v1/products/:productId/segments/post.md) - [API](https://skmtc.dev/configcat/apis/configcat-public-management-api.md) - [Page](https://skmtc.dev/configcat/apis/configcat-public-management-api/changes/v1/products/:productId/segments/post)