---
title: "Add participants"
method: POST
path: "/v1/whatsapp/wa-groups/{groupId}/participants"
tags: ["WhatsApp"]
---

# Add participants

`POST /v1/whatsapp/wa-groups/{groupId}/participants`

Add participants to a WhatsApp group. Maximum 8 participants per request. A group holds at most 8 participants in total (a Meta limit), so later requests cannot grow a group past 8. Meta documents groups as invite-only, so people normally join through the group's invite link.

Not available on [Coexistence](/platforms/whatsapp/connection#whatsapp-business-app-coexistence) numbers. Requires a Cloud API-only number.

## Path parameters

- `groupId` string, required

## Query parameters

- `accountId` string, required

## Request body

- object
  - `phoneNumbers` string[], required — Phone numbers in E.164 format (max 8)

## Response `200`

Participants added

- object
  - `success` boolean
  - `message` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 1 info
  - added the optional property `details/budgetScope` to the response with the `400` status
- **2026-09-15** `0dba7d004d75` — 2 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaScope` to the response with the `400` status

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/whatsapp/wa-groups/:groupId/participants/post.md)

---

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