/folders
folders:create
Header'lar
Authorization
*API key. Format: Bearer xpl_live_...
Idempotency-Key
*Unique value of 1-255 characters to safely retry the same write request.
Content-Type
Use application/json when sending JSON body.
Body
socialSetId
*The Social Set id that owns the folder.
name
*Folder name. Maximum 120 characters.
color
blue, green, lime, yellow, orange, red, purple, black or gray. Default is blue.
order
Ranking value. An integer greater than or equal to zero.
isPinned
Creates the folder as pinned.
Folder behavior
color
Valid values are blue, green, lime, yellow, orange, red, purple, black and gray.
order
When omitted, the folder is appended after the existing folders in the same Social Set.
isPinned
If true is sent, the folder will be created as pinned.
Cevaplar
The folder has been created.
Idempotency-Key conflict or operation in progress.
cURL
curl -X POST https://api.xplanner.co/v1/folders \ -H "Authorization: Bearer $XPLANNER_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: folder-001" \ -d '{ "socialSetId": "set_123", "name": "Lansman fikirleri", "color": "blue", "isPinned": true }'Cevap
{ "data": { "id": "fld_123", "socialSetId": "set_123", "name": "Lansman fikirleri", "color": "blue", "isPinned": true, "order": 0, "workspaceId": "wrk_123", "createdAt": "2026-05-15T09:00:00.000Z", "updatedAt": "2026-05-15T09:00:00.000Z" }, "requestId": "req_123"}