---
title: "Create group"
method: POST
path: "/workspaces/{workspace_id}/groups"
tags: ["groups"]
---

# Create group

`POST /workspaces/{workspace_id}/groups`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/workspaces/{workspace_id}/groups`
- Auth: none declared
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/groups/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a group in the specified workspace

## Path parameters

- `workspace_id` integer, required

## Request body

- GroupNamePayload
  - `name` string

## Response `200`

Returns the created group data.

- ModelsGroup
  - `at` string
  - `id` integer
  - `name` string
  - `permissions` string
  - `workspace_id` integer

## Other responses

- `400`: Possible error messages: * Group name must be present * Group name too long, maximum length is 200 * Name has already been taken
- `403`: User does not have access to this resource

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)