List Folders

List every non-archived folder for the active org (flat array).

GET /folders

List Folders

cURL

curl --request GET \
  --url https://api.example.com/folders \
  --header 'Authorization: Bearer <token>'

200

{}

New to folders? See the Files & Folders guide for how the tree fits into the files feature. This page is the field-level technical reference.

Folders form an adjacency-list tree: each row has a parent_id pointing at its parent, and null means a root-level folder. Returns every non-archived folder in the active org as a flat array, ordered alphabetically by name — the tree structure isn’t pre-built into the response, so reconstruct it yourself from each folder’s parent_id.

Auth

Requires a CRM read scope and an active organization on the token. Any of contacts:read, deals:read, companies:read, or activities:read qualifies, as does any *:manage scope — manage implies read.

Response

Field	Type	Description
folders	array of folder objects	See below.
folders[].id	string (uuid)	Primary key.
folders[].org_id	string (uuid)	Owning organization.
folders[].parent_id	string (uuid) | null	Parent folder, or null for a root-level folder.
folders[].name	string	Folder name, unique among its siblings (case-insensitive).
folders[].created_by	string | null	User id that created the folder.
folders[].created_at	string (ISO 8601)	Creation timestamp.
folders[].updated_at	string (ISO 8601)	Last-modified timestamp.
folders[].archived_at	string | null	Always null in this list — archived folders are excluded.

Authorizations

Authorization · string · header · required

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

Response

200 - application/json

Successful Response

The response is of type Response List Folders Folders Get · object.