---
title: "Create a group"
method: POST
path: "/api/profiles/{profile_id}/whatsapp/create_group"
tags: ["WhatsApp"]
---

# Create a group

`POST /api/profiles/{profile_id}/whatsapp/create_group`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/profiles/{profile_id}/whatsapp/create_group`
- Auth: HTTP bearer

Creates a group owned by the number and returns its invite link.

## Query parameters

- `profile_group_id` string

## Request body

- WhatsAppGroupCreateRequest
  - `phone_number_id` string, required
  - `subject` string, required
  - `description` string
  - `join_approval_mode` 'approval_required' | 'auto_approve'

## Response `200`

The created group.

- object

## Other responses

- `400`: Missing required parameters.
- `401`: Invalid, missing, or insufficient API key permissions.
- `404`: Resource does not exist or is not accessible.
- `422`: Validation failed.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)