---
title: "Create new segment folder"
method: POST
path: "/audiences/{audienceId}/folders"
tags: ["Folders"]
---

# Create new segment folder

`POST /audiences/{audienceId}/folders`

Create a new parent segment folder.

## Path parameters

- `audienceId` integer, required

## Request body

- SegmentFolderCreateRepresentation
  - `name` string, required
  - `description` string, required

## Response `200`

Returns the segment folder which was created

- SegmentFolderReadRepresentation
  - `id` string
  - `audienceId` string — ID of the parent audience. For composable folders this carries the composable audience id; the complete-vs-composable discriminator lives on the parent audience entity, not on the folder.
  - `name` string
  - `description` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `createdBy` union
    - User
      - `id` string
      - `td_user_id` string
      - `name` string
    - NullValue, nullable
      - `thisKeyNeverHit` string
  - `updatedBy` union
    - User
      - `id` string
      - `td_user_id` string
      - `name` string
    - NullValue, nullable
      - `thisKeyNeverHit` string

---

[API](https://skmtc.net/treasure/apis/cdp-api.md) · [All operations](https://skmtc.net/treasure/apis/cdp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasure/cdp-api/revisions/24caa8eb809b/schema)