TagMangoTagMango Docs
Community

Create a community channel group

POST
/api/v1/external/community/channel-groups

Create a group to organize the community sidebar. A group by itself has no channels and does nothing except label and order them — attach channels to it afterwards via the create-channel endpoint's group field. The new group is always appended after all of this creator's existing groups (matching the dashboard's own behavior) — there is no way to insert it at a specific position.

Fails with a 400 if name is missing or empty, or if the Community feature is not enabled for this creator.

AuthorizationBearer <token>

In: header

Header Parameters

x-whitelabel-host*string

Host name of the dashboard, ex: mydomain.tagmango.com

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api-prod-new.tagmango.com/api/v1/external/community/channel-groups" \  -H "x-whitelabel-host: string" \  -H "Content-Type: application/json" \  -d '{    "name": "Get started"  }'
{
  "_id": "6659ca9e5f2acb7abfdcd8fd",
  "name": "Get started",
  "hideFromNonChannelMember": false,
  "rank": 92,
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}
{
  "code": 400,
  "type": "Bad Request",
  "statusMessage": "BAD_REQUEST",
  "success": false,
  "message": "Invalid request",
  "result": "Invalid request"
}
{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "Invalid token",
  "result": "Invalid token",
  "success": false
}
{
  "code": 403,
  "type": "Forbidden",
  "statusMessage": "FORBIDDEN",
  "errorCode": "WORKSHOP_MANGO_FORBIDDEN",
  "message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "success": false
}
{
  "code": 429,
  "type": "Too Many Requests",
  "statusMessage": "TOO_MANY_REQUESTS",
  "message": "Request limit exceeded. try after 10 seconds",
  "result": "Request limit exceeded. try after 10 seconds",
  "success": false
}