# Create a collection

Creates a new collection in your organization's help center.

### Request Body

Required attributes:
- name - The name of the collection

Optional attributes:
- description - A description of the collection
- icon - An icon object representing the collection icon (with type and value)
- parentId - The ID of the parent collection, if any
- translations - A dictionary of translations keyed by locale

### Response

Returns the created collection object with:
- id - Unique identifier
- name - Collection name
- description - Collection description
- slug - URL slug
- icon - Collection icon (emoji or custom)
- parentId - Parent collection ID (null for root collections)
- helpCenterId - ID of the help center this collection belongs to
- organization - Organization ID
- defaultLocale - Default locale for content
- locale - Current locale
- availableLocales - Array of available locales
- featurebaseUrl - Featurebase URL for the collection
- externalUrl - External URL if custom domain is configured
- articleCount - Number of articles in this collection
- authorCount - Number of authors who contributed
- order - Display order
- translations - Translations for different locales
- createdAt - ISO 8601 timestamp when created
- updatedAt - ISO 8601 timestamp when last updated

Endpoint: POST /v2/help_center/collections
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Request fields (application/json):

  - `name` (string, required)
    The name of the collection
    Example: "English Collection"

  - `description` (string)
    A description of the collection
    Example: "This is a collection of articles in English."

  - `icon` (object,null)
    An updated icon object for the collection

  - `icon.type` (string, required)
    Icon type (e.g., "emoji")
    Enum: "emoji", "predefined"

  - `icon.value` (string, required)
    Icon value
    Example: "📝"

  - `parentId` (string,null)
    The ID of the parent collection, if any

  - `translations` (object)
    A dictionary of translations keyed by locale

  - `translations.bn` (object)

  - `translations.bn.name` (string)
    Collection name in this locale
    Example: "German Collection"

  - `translations.bn.description` (string)
    Collection description in this locale
    Example: "This is a collection of articles in German."

  - `translations.bs` (object)

  - `translations.pt-BR` (object)

  - `translations.bg` (object)

  - `translations.ca` (object)

  - `translations.hr` (object)

  - `translations.cs` (object)

  - `translations.da` (object)

  - `translations.nl` (object)

  - `translations.en` (object)

  - `translations.et` (object)

  - `translations.fi` (object)

  - `translations.fr` (object)

  - `translations.de` (object)

  - `translations.el` (object)

  - `translations.hi` (object)

  - `translations.hu` (object)

  - `translations.id` (object)

  - `translations.it` (object)

  - `translations.ja` (object)

  - `translations.ko` (object)

  - `translations.lv` (object)

  - `translations.lt` (object)

  - `translations.ms` (object)

  - `translations.mn` (object)

  - `translations.nb` (object)

  - `translations.pl` (object)

  - `translations.pt` (object)

  - `translations.ro` (object)

  - `translations.ru` (object)

  - `translations.sr` (object)

  - `translations.zh-CN` (object)

  - `translations.sk` (object)

  - `translations.sl` (object)

  - `translations.es` (object)

  - `translations.sw` (object)

  - `translations.sv` (object)

  - `translations.th` (object)

  - `translations.zh-TW` (object)

  - `translations.tr` (object)

  - `translations.uk` (object)

  - `translations.vi` (object)

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "collection"

  - `id` (string, required)
    Collection unique identifier
    Example: "6474684"

  - `name` (string)
    Collection name
    Example: "English Collection Name"

  - `description` (string)
    Collection description
    Example: "A description in English"

  - `slug` (string)
    URL slug
    Example: "6474684-english-version"

  - `icon` (object,null)
    Collection icon

  - `icon.type` (string, required)
    Icon type
    Example: "emoji"

  - `icon.value` (string, required)
    Icon value
    Example: "🥾"

  - `parentId` (string,null, required)
    Parent collection ID

  - `helpCenterId` (string, required)
    Help center ID
    Example: "j7c5g8ah3ewxp4lo"

  - `organization` (string, required)
    Organization ID
    Example: "6595518396205e06b897ad65"

  - `defaultLocale` (string)
    Default locale
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `locale` (string, required)
    Current locale
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `availableLocales` (array, required)
    Available locales
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `featurebaseUrl` (string)
    Featurebase URL
    Example: "https://yourorg.featurebase.app/en/help/collections/6474684-english-version"

  - `externalUrl` (string)
    External URL
    Example: "https://help.yourdomain.com/en/collections/6474684-english-version"

  - `articleCount` (number)
    Number of articles
    Example: 15

  - `authorCount` (number)
    Number of authors
    Example: 3

  - `order` (number,null)
    Display order
    Example: 1

  - `path` (string)
    Collection path
    Example: "ox6qrqprmsuqaunj/3876752/3513543"

  - `collapseSidebar` (boolean)
    Whether to collapse sidebar

  - `translations` (object)
    Translations by locale code

  - `translations.bn` (object)

  - `translations.bn.authors` (array)
    List of authors

  - `translations.bn.authors.name` (string)
    Author name
    Example: "John Doe"

  - `translations.bn.authors.authorId` (string)
    Author ID
    Example: "507f1f77bcf86cd799439011"

  - `translations.bn.authors.avatarUrl` (string,null)
    Author avatar URL
    Example: "https://example.com/avatar.png"

  - `translations.bs` (object)

  - `translations.pt-BR` (object)

  - `translations.bg` (object)

  - `translations.ca` (object)

  - `translations.hr` (object)

  - `translations.cs` (object)

  - `translations.da` (object)

  - `translations.nl` (object)

  - `translations.en` (object)

  - `translations.et` (object)

  - `translations.fi` (object)

  - `translations.fr` (object)

  - `translations.de` (object)

  - `translations.el` (object)

  - `translations.hi` (object)

  - `translations.hu` (object)

  - `translations.id` (object)

  - `translations.it` (object)

  - `translations.ja` (object)

  - `translations.ko` (object)

  - `translations.lv` (object)

  - `translations.lt` (object)

  - `translations.ms` (object)

  - `translations.mn` (object)

  - `translations.nb` (object)

  - `translations.pl` (object)

  - `translations.pt` (object)

  - `translations.ro` (object)

  - `translations.ru` (object)

  - `translations.sr` (object)

  - `translations.zh-CN` (object)

  - `translations.sk` (object)

  - `translations.sl` (object)

  - `translations.es` (object)

  - `translations.sw` (object)

  - `translations.sv` (object)

  - `translations.th` (object)

  - `translations.zh-TW` (object)

  - `translations.tr` (object)

  - `translations.uk` (object)

  - `translations.vi` (object)

  - `createdAt` (string, required)
    ISO 8601 timestamp when created
    Example: "2024-10-18T12:33:09.099Z"

  - `updatedAt` (string, required)
    ISO 8601 timestamp when last updated
    Example: "2024-10-18T13:03:25.921Z"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_request"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400