Skip to content
Home/
REST API Reference
/
/
Create a folder

Create a folder

Request

You can create a new folder for organizing content by making a POST request to https://api.intercom.io/folders.

Security
bearerAuth
Headers
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
Bodyapplication/json
folderobjectrequired
curl -i -X POST \
  https://api.intercom.io/folders \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Intercom-Version: Preview' \
  -d '{
    "folder": {
      "name": "Product Documentation",
      "description": "Internal product docs",
      "emoji": "📚"
    }
  }'

Responses

folder created

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": 0,
  "created_at": 1672928359,
  "updated_at": 1672928359
}