---
title: "Create a collection"
method: POST
path: "/help_center/collections"
tags: ["Help Center"]
---

# Create a collection

`POST /help_center/collections`

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

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Request body

- CreateCollectionRequest — You can create a collection
  - `name` string, required — The name of the collection. For multilingual collections, this will be the name of the default language's content.
  - `description` string — The description of the collection. For multilingual collections, this will be the description of the default language's content.
  - `translated_content` GroupTranslatedContent, nullable — The Translated Content of an Group. The keys are the locale codes and the values are the translated content of the Group.
    - `type` 'null' | 'group_translated_content', nullable — The type of object - group_translated_content.
    - `ar` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `bg` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `bs` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ca` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `cs` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `da` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `de` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `el` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `en` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `es` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `et` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `fi` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `fr` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `he` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `hr` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `hu` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `id` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `it` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ja` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ko` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `lt` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `lv` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `mn` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `nb` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `nl` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `pl` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `pt` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ro` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ru` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `sl` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `sr` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `sv` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `tr` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `vi` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `pt-BR` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `zh-CN` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `zh-TW` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
  - `parent_id` string, nullable — The id of the parent collection. If `null` then it will be created as the first level collection.
  - `help_center_id` integer, nullable — The id of the help center where the collection will be created. If `null` then it will be created in the default help center.

## Response `200`

collection created

- Collection — Collections are top level containers for Articles within the Help Center.
  - `id` string — The unique identifier for the collection which is given by Intercom.
  - `workspace_id` string — The id of the workspace which the collection belongs to.
  - `name` string — The name of the collection. For multilingual collections, this will be the name of the default language's content.
  - `description` string, nullable — The description of the collection. For multilingual help centers, this will be the description of the collection for the default language.
  - `created_at` integer — The time when the article was created (seconds). For multilingual articles, this will be the timestamp of creation of the default language's content.
  - `updated_at` integer — The time when the article was last updated (seconds). For multilingual articles, this will be the timestamp of last update of the default language's content.
  - `url` string, nullable — The URL of the collection. For multilingual help centers, this will be the URL of the collection for the default language.
  - `icon` string, nullable — The icon of the collection.
  - `order` integer — The order of the section in relation to others sections within a collection. Values go from `0` upwards. `0` is the default if there's no order.
  - `default_locale` string — The default locale of the help center. This field is only returned for multilingual help centers.
  - `translated_content` GroupTranslatedContent, nullable — The Translated Content of an Group. The keys are the locale codes and the values are the translated content of the Group.
    - `type` 'null' | 'group_translated_content', nullable — The type of object - group_translated_content.
    - `ar` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `bg` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `bs` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ca` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `cs` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `da` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `de` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `el` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `en` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `es` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `et` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `fi` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `fr` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `he` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `hr` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `hu` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `id` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `it` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ja` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ko` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `lt` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `lv` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `mn` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `nb` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `nl` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `pl` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `pt` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ro` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `ru` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `sl` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `sr` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `sv` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `tr` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `vi` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `pt-BR` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `zh-CN` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
    - `zh-TW` GroupContent, nullable — The Content of a Group.
      - `type` 'null' | 'group_content', nullable — The type of object - `group_content` .
      - `name` string — The name of the collection or section.
      - `description` string — The description of the collection. Only available for collections.
  - `parent_id` string, nullable — The id of the parent collection. If `null` then it is the first level collection.
  - `help_center_id` integer, nullable — The id of the help center the collection is in.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/revisions/9517e80f2642/schema)