# Create a folder

`POST https://app.clik.so/api/folders`

> **In short:** Makes a new, empty folder. Put links in it with `folder_id` when you create or update them.

## You need

* **API key permission:** `write`
* **Workspace role:** editor or higher
* **Plan:** some fields need a paid plan — see "Plan-gated fields" below.

## Example

```bash
curl -X POST "https://app.clik.so/api/folders" \
  -H "Authorization: Bearer $CLIKSO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Campaigns"
  }'
```

Response 201:

```json
{
  "status": 201,
  "success": true,
  "message": "Created",
  "data": {
    "id": "6b7c8d9e-0f1a-4b2c-8d3e-4f5a6b7c8d9e",
    "name": "Campaigns",
    "created_at": "2026-10-09T09:30:00.000Z",
    "updated_at": "2026-10-09T09:30:00.000Z",
    "link_count": 0
  }
}
```

## Request body

| Field  | Type   | Required | Description                                             |
| ------ | ------ | -------- | ------------------------------------------------------- |
| `name` | string | yes      | The folder's name, up to 20 characters. 1–20 characters |

## Plan-gated fields

| Field  | Feature | Lowest plan                                                                         |
| ------ | ------- | ----------------------------------------------------------------------------------- |
| `name` | folders | A new folder past the plan's folder count (Free 3, Starter 6, Pro 15, Business 40). |

## Common errors

| Status | Code               | When                                                                            |
| ------ | ------------------ | ------------------------------------------------------------------------------- |
| 401    | `UNAUTHORIZED`     | The API key is missing, malformed or unknown.                                   |
| 402    | `UPGRADE_REQUIRED` | The workspace already has as many folders as its plan allows.                   |
| 403    | `FORBIDDEN`        | The key only has Read permission, or its creator is a viewer in this workspace. |
| 422    | `VALIDATION_ERROR` | `name` is missing, empty or longer than 20 characters.                          |
| 429    | `RATE_LIMITED`     | The key went over its per-minute request limit.                                 |

## Good to know

* The name can be up to 20 characters. Spaces at the start and end are removed.
* Folder names do not have to be unique.
* Each plan allows a number of folders: Free 3, Starter 6, Pro 15, Business 40. Past it you get `402 UPGRADE_REQUIRED`.

---

Source: https://clik.so/docs/api/folders/create-folder