---
title: "Create manual segment"
method: POST
path: "/channel/v1/segments"
tags: ["SegmentFolders"]
---

# Create manual segment

`POST /channel/v1/segments`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/channel/v1/segments`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/channel/v1/segments/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a manual segment. Manual segments allow Marketplace Managers to select companies manually, as opposed to dynamic segments, which contain user selected automatically based on filter values.

## Query parameters

- `companyGroupId` string, required

## Request body

- SegmentRequest: Data required to create a segment
  - `name` string, required: Segment name
  - `code` string: Segment code

## Response `200`

OK

- Segment: A characteristic shared by segment folder members
  - `id` string: Segment ID
  - `name` string: Segment name
  - `code` string: Segment codes are unique codes that you can use for B2B integration by using the API to automatically associate companies with segments. Leave this field blank if a segment code is not required. Note that if you modify the code after you create it, your B2B integration might be affected.
  - `partner` string: Partner name
  - `type` 'MANUAL' | 'DYNAMIC': Segment type

## Other responses

- `400`: Bad request
- `409`: The segment already exists

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/channel/v1/segments/post.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)