Create a section

Creates a top-level section in your help center navigation.

POST /v1/sections

Bearer token scope content:write

curl 'https://api.ferndesk.com/v1/sections' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Guides",
  "slug": "guides",
  "iconData": {
    "type": "huge",
    "id": "book-01"
  }
}'

{
  "id": "sect_01JXYA4T1JNT",
  "helpdeskId": "help_01JXYA7B3T7G",
  "name": "Guides",
  "iconData": {
    "type": "huge",
    "id": "book-01"
  },
  "isDefault": false,
  "position": 1,
  "createdAt": "2026-01-15T18:25:43.511Z",
  "updatedAt": "2026-01-15T18:25:43.511Z",
  "translations": []
}

Created section

Body

required application/json

name string · min length: 1 required

Section name.

slug string · min length: 1

URL slug; derived from the name when omitted.

iconData any

Icon shown beside the section in the help center navigation.

Body

Responses