---
title: "Create a new user group"
method: POST
path: "/v4/queue-user-group"
tags: ["Queue User Group V4"]
---

# Create a new user group

`POST /v4/queue-user-group`

## Request

- Base URL: `https://developer.meetergo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.meetergo.com/v4/queue-user-group`
- Auth: one of:
  - API key in header `x-meetergo-api-user-id`
  - HTTP bearer
  - HTTP bearer

## Request body

- CreateUserGroupDto
  - `queueId` string, required: ID of the queue this group belongs to
  - `name` string, required: Name of the user group

## Response `201`

User group created successfully

- QueueUserGroupResponseDto
  - `id` string, required
  - `name` string, required
  - `capacity` number, required
  - `users` UserBasicDto[], required
    - `id` string, required
    - `givenName` string, required
    - `familyName` string, required
    - `picture` string
    - `slug` string, required
    - `userType` string, required
  - `userIds` string[], required
  - `queueId` string, required
  - `mainGroupHost` UserBasicDto
    - `id` string, required
    - `givenName` string, required
    - `familyName` string, required
    - `picture` string
    - `slug` string, required
    - `userType` string, required
  - `mainGroupHostId` string, nullable
  - `createdAt` string, required
  - `updatedAt` string, required
  - `deletedAt` string, nullable

## Other responses

- `400`: The request did not validate. `message` lists the constraints that failed.
- `401`: Missing, malformed, or expired credentials.
- `403`: Authenticated, but not allowed: the plan does not include this feature, or the token is scoped away from it.
- `429`: Rate limited. Back off and retry.

---

[API](https://skmtc.dev/meetergo/apis/meetergo-platform-api.md) · [All operations](https://skmtc.dev/meetergo/apis/meetergo-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meetergo/apis/meetergo-platform-api/revisions/b5d66cd8be67?raw)