> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autocalls.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create folder

> Create a folder to organize your assistants

Create a folder to group your assistants. Assign assistants to a folder with the `folder_id` field on the [Create assistant](/api-reference/assistants/create-assistant) and [Update assistant](/api-reference/assistants/update-assistant) endpoints.

### Request Body

<ParamField body="name" type="string" required>
  The folder name (max 255 characters). Must be unique within your account.
</ParamField>

<ParamField body="color" type="string">
  A color for the folder badge. One of: `gray`, `slate`, `red`, `orange`, `amber`, `green`, `teal`, `blue`, `purple`, `pink`.
</ParamField>

### Response

<ResponseField name="message" type="string">Success message</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="integer">The unique identifier of the created folder</ResponseField>
    <ResponseField name="name" type="string">The folder name</ResponseField>
    <ResponseField name="color" type="string">The folder color (or `null`)</ResponseField>
    <ResponseField name="assistants_count" type="integer">Number of assistants in this folder (always `0` for a new folder)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 201 Success Response theme={null}
  {
    "message": "Folder created successfully",
    "data": { "id": 12, "name": "Acme Corp", "color": "blue", "assistants_count": 0 }
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "The name has already been taken.",
    "errors": { "name": ["The name has already been taken."] }
  }
  ```
</ResponseExample>