---
title: "Utwórz grupę"
method: POST
path: "/v1/groups"
tags: ["Kontakty i grupy"]
---

# Utwórz grupę

`POST /v1/groups`

## Request

- Base URL: `https://api.przypominamy.com`
- URL: `https://api.przypominamy.com/v1/groups`
- Auth: HTTP bearer

Nazwa do 80 znaków, unikalna w koncie (bez rozróżniania wielkości liter). Grupę tworzy też automatycznie `POST /v1/contacts` z nieznaną nazwą w `groups`. Wymaga zakresu `manage`.

## Request body

- object
  - `name` string, required

## Response `201`

Utworzono

- Group
  - `id` string
  - `name` string
  - `members` integer: Liczba kontaktów w grupie
  - `created_at` string, date-time

## Other responses

- `400`: Błąd walidacji
- `401`: Brak lub nieprawidłowy klucz API
- `403`: Klucz bez wymaganego zakresu (albo konto zawieszone / testowe wysyła na niezweryfikowany numer)
- `409`: Grupa o tej nazwie już istnieje

---

[API](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api.md) · [All operations](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/revisions/c20f9cfc2a7d?raw)