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

# Create segment folders

`POST /channel/v1/companyGroups`

## Request

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

Creates a segment folder

## Request body

- SegmentFolderRequest: Segment folder creation request
  - `name` string, required: Segment folder name

## Response `200`

Success

- SegmentFolder: Segment folder
  - `id` string: Segment folder ID
  - `name` string, required: Segment folder name
  - `partner` string: Partner name

## Other responses

- `400`: Bad request
- `409`: The segment folder name already exists for the partner

## Changes

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

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/channel/v1/companyGroups/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)