Intercom API (unofficial showcase)
GET/folders

List folders

Lists folders used to organize content. Use parent_folder_id to list only the direct children of a specific folder, and use page and per_page to paginate the results.

4 parameters
pageintegeroptional
The page number of results to retrieve.
per_pageintegeroptional
The number of results to return per page.
parent_folder_idintegeroptional
The ID of a folder; limits results to its direct child folders.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

2 status codes
200Returns a list of folders, the total folder count, and pagination metadata.
typestringoptional
Allowed:list
dataarray<Folder>optional
total_countintegeroptional
Total number of folders
pagesobjectoptional
The majority of list resources in the API are paginated to allow clients to traverse data over multiple requests. Their responses are likely to contain a pages object that hosts pagination links which a client can use to paginate through the data without having to construct a query. The link relations for the pages field are as follows.
401Returned when the request is not authorized.
typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 401 is returned when the request is not authorized. Use page and per_page to control pagination, and parent_folder_id to filter for a folder's direct children.