Retrieve a folder

Request

You can fetch the details of a single folder by making a GET request to https://api.intercom.io/folders/<id>.

Security

bearerAuth

Path

idintegerrequired

The unique identifier for the folder

Example:6

Intercom-Versionstring(intercom_version)

Intercom API version.
By default, it's equal to the version set in the app package.

Default:"Preview"

Enum:"1.0""1.1""1.2""1.3""1.4""2.0""2.1""2.2""2.3""2.4"

Example:Preview

curl -i -X GET \
  https://api.intercom.io/folders/6 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Intercom-Version: Preview'

Responses

folder found

Bodyapplication/json

idinteger

The unique identifier for the folder

Example:6

namestring

The name of the folder

Example:"Product Documentation"

descriptionstring or null

The description of the folder

Example:"Internal product documentation"

emojistring or null

An emoji associated with the folder

Example:"📚"

parent_folder_idinteger or null

The ID of the parent folder, or null if this is a root folder

Example:null

content_countinteger

The number of content items in this folder

Example:5

created_atinteger, (date-time)

The time when the folder was created (seconds)

Example:1672928359

updated_atinteger, (date-time)

The time when the folder was last updated (seconds)

Example:1672928610

Response

{
  "id": 6,
  "name": "Product Documentation",
  "description": "Internal product docs",
  "emoji": "📚",
  "parent_folder_id": null,
  "content_count": 5,
  "created_at": 1672928359,
  "updated_at": 1672928610
}