---
title: "Create New Folder"
method: POST
path: "/studio/v1/folders"
tags: ["Audiences"]
---

# Create New Folder

`POST /studio/v1/folders`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/studio/v1/folders`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:audience:manage`

Creates a new folder for organizing audiences in GTM Studio.
Folders group related audiences together, making it easier to navigate and manage large collections — for example, grouping by campaign, region, or team.
Specify `name` and optionally set `starred` to `true` to mark the folder for quick access. The folder is created empty; audiences are assigned to it via the Create Audience or Update Audience endpoints using `folderId`.
Returns `201 Created` with the full folder resource including the system-assigned `folderId` and creation metadata.
Returns `400` if required fields are missing or invalid.

## Request body

- FolderJsonApiModelCreate: JSON API model for Folder.
  - `data` FolderCreate, required: Folder request resource.
    - `type` string, required: The type of the resource
    - `attributes` FolderAttributes, required: Attributes for a folder that organizes audiences in GTM Studio.
      - `name` string, required: Display name of the folder. Required on create.
      - `description` string: Optional free-text description of the folder's purpose.
      - `notes` string: Optional notes about the folder for internal reference.
      - `starred` boolean: Whether the folder is starred for quick access. Optional; defaults to `false`.
      - `audiences` string[]: List of `audienceId` values for the audiences contained in this folder. Read-only; updated automatically as audiences are added or moved.

## Response `201`

Created

- FolderJsonApiModel: JSON API model for Folder.
  - `data` Folder, required: Folder request resource.
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` FolderAttributes, required: Attributes for a folder that organizes audiences in GTM Studio.
      - `name` string, required: Display name of the folder. Required on create.
      - `description` string: Optional free-text description of the folder's purpose.
      - `notes` string: Optional notes about the folder for internal reference.
      - `starred` boolean: Whether the folder is starred for quick access. Optional; defaults to `false`.
      - `audiences` string[]: List of `audienceId` values for the audiences contained in this folder. Read-only; updated automatically as audiences are added or moved.
    - `meta` FolderMeta: Metadata for Folder model.
      - `createdAt` string, date-time, required: The timestamp when the resource was created
      - `createdById` integer, required: Id of the user who created the resource
      - `createdByName` string, required: Name of the user who created the resource
      - `updatedAt` string, date-time, required: The timestamp when the resource was last updated
      - `updatedById` integer, required: Id of the user who last updated the resource
      - `updatedByName` string, required: Name of the user who last updated the resource

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/gtm-studio-api-v1/revisions/93a0bebaaac8?raw)