---
title: "Create"
method: POST
path: "/public/api/groups"
tags: ["Groups"]
---

# Create

`POST /public/api/groups`

You may create a new single group or multiple groups using this action.
When creating a single group the body contains a json object, when creating multiple groups the body contains an array of objects.    
**Warning: a maximum of 1000 items can be sent in a single request.**

**Important:**
The `group_id` is generated automatically when a new group is created. The `group_id` corresponds to the group's title in lowercase letters, with `_` instead of spaces, and without special caracters

## Headers

- `Accept` string

## Request body

- object
  - `user_ids` string[]
  - `title` string
  - `description` string
  - `icon_url` string

## Response `200`

OK

- object[]
  - `group_id` string, required
  - `user_ids` string[], required
  - `updated_date` string, required
  - `created_date` string, required
  - `title` string, required
  - `description` string
  - `icon_url` string
  - `group_ids` string[]

---

[API](https://skmtc.net/yoobic/apis/yoobic-public-api.md) · [All operations](https://skmtc.net/yoobic/apis/yoobic-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yoobic/yoobic-public-api/revisions/dd57df399bc4/schema)