---
title: "Create a group"
method: POST
path: "/api/1/groups"
tags: ["Groups (Preferred)"]
---

# Create a group

`POST /api/1/groups`

Creates a new group.

Requires the **GROUPMANAGEMENT** security role.

## Request body

- object
  - `name` string, required — Name of the group. Must be unique within the account. Must be a string (numbers are not coerced).
  - `description` string, nullable — Optional description of the group.

## Response `201`

Group created successfully.

- Group
  - `id` string, uuid
  - `title` string
  - `description` string
  - `guideIds` string[]
  - `guides` GuideOverview[]
    - `id` string, uuid
    - `creationTime` string
    - `lastModifiedTime` string
    - `title` string
    - `visibility` 'PRIVATE' | 'SPECIFIC' | 'PORTAL' | 'PUBLIC'
    - `version` integer
    - `ownerId` string
    - `cover` Cover
      - `assetId` string
      - `assetName` string
      - `imageUrl` string
      - `detailUrl` string
    - `isFeatured` boolean
    - `type` 'MULTI_PAGE' | 'SINGLE_PAGE' | 'HOME_PAGE'
    - `groupId` string, uuid
    - `canEdit` boolean
    - `canView` boolean
    - `shared` boolean
    - `targetedPagesEnabled` boolean
  - `visibility` 'PRIVATE' | 'SPECIFIC' | 'PORTAL' | 'PUBLIC'
  - `ownerId` string
  - `version` integer
  - `creationTime` string
  - `lastModifiedTime` string
  - `cover` object
    - `colorId` string
    - `assetId` string
    - `assetName` string
    - `imageUrl` string
    - `detailUrl` string
  - `canEdit` boolean
  - `canView` boolean
  - `shared` boolean

## Other responses

- `401` — Missing or invalid authentication. The response body is empty.
- `403` — The authenticated user does not have the **GROUPMANAGEMENT** security role.
- `409` — A group with this name already exists.
- `422` — Validation error (e.g. `name` is missing or not a string).

---

[API](https://skmtc.net/bynder/apis/oauth-2-0.md) · [All operations](https://skmtc.net/bynder/apis/oauth-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bynder/oauth-2-0/versions/bb9efc864ce1/schema)