---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://appmetrica.yandex.com.tr/docs/en/mobile-api/push/post-groups.md
  - https://appmetrica.yandex.com.tr/docs/ru/mobile-api/push/post-groups.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com.tr/docs/en/llms.txt

# Creating a group

Creates a [group](*group) for sending push messages to the specified application.

## Request format {#request-format}

```
POST https://push.api.appmetrica.yandex.net/push/v1/management/groups
```

## Request body

```json translate=no
{
  "group": {
    "app_id": int,
    "name": "string",
    "send_rate": int
  }
}
```

#|
|| `group` | Group for sending push messages. ||
|| `group.app_id`* | App ID to create the group for. ||
|| `group.name`* | Unique name of the group. ||
|| `group.send_rate` | Dispatch speed limit for push messages (messages per second).

The default value is 5000 (maximum).

The minimum value is 100.
 ||
|#

## Response format {#response-format}

```json translate=no
{
  "group": {
    "id": int,
    "app_id": int,
    "name": "string",
    "send_rate": int
  }
}
```
#|
|| `group` | Group for sending push messages. ||
|| `group.id` | ID of the created group. ||
|| `group.app_id` | App ID to create the group for. ||
|| `group.name` | Unique name of the group. ||
|| `group.send_rate` | Dispatch speed limit for push messages (messages per second).

The default value is 5000 (maximum).

The minimum value is 100.
 ||
|#

## Sample request

> ```bash translate=no
> curl -X POST \
>   https://push.api.appmetrica.yandex.net/push/v1/management/groups \
>   -H 'Authorization: OAuth AQAAAAAR62cMAAQgnh4fTgjnrEH...' \
>   -H 'Content-Type: application/json' \
>   -d '{
>   "group": {
>     "app_id": XXXXXX,
>     "name": "group-name",
>     "send_rate": 200
>   }
> }'
> ```

<!-- source: en/_includes/feedback-button-2.md -->
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.

<a href="../../troubleshooting/feedback-new">
  <span class="button">Contact support</span>
</a>

<a href="../../troubleshooting/feedback-docs">
  <span class="button">Suggest an improvement for documentation</span>
</a>
<!-- endsource: en/_includes/feedback-button-2.md -->

[*group]: A group is a container for sending push messages. It allows grouping messages sendings in the [push campaign report](https://appmetrica.yandex.com.tr/docs/en/mobile-reports/push-campaign.md). The group can contain an arbitrary number of sendings. The push campaign report displays these groups at the first level along with push campaigns that are launched through the [web interface](https://appmetrica.yandex.com.tr/docs/en/push/marketing.md).