Resources
Create a creative folder
Create a folder to save finished files in.
POST /api/creative-collectionsRequires creatives:update. Returns 201 with the new folder.
| Field | Required | Description |
|---|---|---|
workspace | Yes | Workspace slug or id. |
name | Yes | Folder name. Cannot be empty. |
description | No | Free-form note. |
curl --request POST "https://app.kalpana.one/api/creative-collections" \
--header "x-api-key: $KALPANA_API_KEY" \
--header "content-type: application/json" \
--data '{"workspace":"acme","name":"Festive sale"}'Response
{
"id": "0192f8a4-6c1e-7c3a-9b0e-4d2f1a7e5c11",
"workspaceId": "ws_123",
"name": "Festive sale",
"description": null,
"createdBy": "user_123",
"createdAt": "2026-09-01T10:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z"
}Folder names do not have to be unique in a workspace, so a second folder with the same name is created alongside the first.
Use the id as collection in Create a batch, so the batch's files are saved in this folder.
Was this page helpful?
Updated 9 Nov 2026