---
title: "Create a group"
description: "Creates a group on the Mindtickle platform with a name, and returns the group ID."
contentType: "api-reference"
url: "https://developer.mindtickle.com/docs/users-and-groups/groups/create-a-group/"
---

## Prerequisites

1. [Authentication and setup](/docs/getting-started/authentication-and-setup/): A valid access token.

## Endpoint

```http
POST /services/data/v2.0/mtobjects/Group
```

Base URL: the standard REST host for your region. See [Base URLs](/docs/getting-started/authentication-and-setup/#base-urls).

Headers: `Authorization: Bearer ACCESS_TOKEN`, `Content-Type: application/json`.

## Request

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | Required | Group name, from 3 to 50 characters. Missing, empty, shorter, or longer names return HTTP 400. |

### Request example

```json
{
  "name": "APAC Sales"
}
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `requestId` | string or null | Request identifier. The response examples return `null`. |
| `responseCode` | integer | Special response codes from the server. |
| `responseType` | string | Type of response from the server. |
| `taskCompleted` | boolean | Completion flag for this request. This endpoint returns its result directly. |
| `group` | Group | Information on the group you have created. |
| `group.name` | string | Name of the group. |
| `group.id` | string | Mindtickle ID of the group. |

### Response example

```json
{
  "requestId": null,
  "responseCode": 0,
  "responseType": "GROUP",
  "taskCompleted": true,
  "group": {
    "name": "APAC Sales",
    "id": "1234567890123456101"
  }
}
```

## Related

- [Add a user to groups](/docs/users-and-groups/users/add-a-user-to-groups/): Add users to the group after creating it.
- [Update a group](/docs/users-and-groups/groups/update-a-group/): Rename the group later.
- [Invite groups to a series](/docs/users-and-groups/groups/invite-groups-to-a-series/): Invite the group to a series.