API ReferenceBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Create a collection

Example Request & Response (Multilingual Help Center)

$ curl https://api.intercom.io/help_center/collections \
-X POST \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json'
-H 'Content-Type: application/json' -d

{
  "name": "Collection 1",
  "description": "English description",
  "translated_content": {
    "es": {
      "name": "Colección 1",
      "description": "Spanish description"
    }
  }
}
HTTP/1.1 200 OK
{
  "id": 1,
  "type": "collection",
  "workspace_id": "abcdef",
  "name": "Collection 1",
  "description": "English description", 
  "created_at": 123456,
  "updated_at": 123456,
  "url": "http://intercom.test/help/collection/collection-1",
  "icon": "http://intercom/help_center/icon-1",
  "order": 0,
  "default_locale": "en",
  "translated_content": {
    "type": "group_translated_content",
    "es": {
      "type": "group_content",
      "name": "Colección 1",
      "description": "Spanish description"
    }
  }
}

You can create a new collection by making a POST request to https://api.intercom.io/help_center/collections.

Request Body Parameters

KeyTypeRequired?Description
nameStringYesThe name of the collection.
For multilingual collections, this will be the name of the default language's content.
descriptionStringNoThe description of the collection.
For multilingual collections, this will be the description of the default language's content.
translated_contentStringNoA Group Translated Content Object whereby you can specify multiple multilingual collections to be created.

Response

This will return a Collection Model of the collection you just created.