Create a Folder

Create a folder. parent_id=NULL creates a root-level folder.

POST /folders

Create Folder

cURL

curl --request POST \
  --url https://api.example.com/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "parent_id": "<string>"
}
'

200

{}

Folder names must be unique among siblings at the same parent, case-insensitively — enforced by a database constraint on (org_id, parent_id, lower(name)). Creating into a collision returns 409.

Auth

Requires a CRM manage scope and an active organization on the token. Any *:manage scope qualifies — in practice contacts:manage, deals:manage, companies:manage, or activities:manage.

Response

Returns the created folder row — same shape as one element of folders[] in List Folders.

Errors

Status	Cause
400 Bad Request	name is empty (or only whitespace).
404 Not Found	parent_id doesn’t exist, isn’t in this org, or is archived.
409 Conflict	A non-archived folder with this name already exists under the same parent.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string · required

Folder name; must be unique among siblings at the same parent (case-insensitive).

parent_id · string | null

Parent folder id; omit or null to create a root-level folder.

Response

200

application/json

Successful Response

The response is of type Response Create Folder Folders Post · object.