---
title: "Add Participant to Group"
method: POST
path: "/chats/{chat_id}/add"
tags: ["chats", "group"]
---

# Add Participant to Group

`POST /chats/{chat_id}/add`

This endpoint adds a participant to a group

_Note that adding unknown numbers is a spammy action and can result in a ban_

_Per Meta's policies, a user will be added to a group directly only if they have enabled it in their privacy settings, and they are a member of your phone contacts_

_For all other cases, this will send an invite to them to join the group_

## Headers

- `x-phone` string

## Request body

- object
  - `participants` string[], required — - Provide a list of participants to be added to the group (in country_code + number format). - Participants will be directly added to the group if they are in your phone contacts and their privacy settings allow it. If not, participants will receive an invite to join the group
  - `force_add_participants` boolean — - When set to true, all participants will be attempted to be added directly to group. - Default false

## Response `200`

200 OK

- object — The response is an object with `is_success` value for each participant

---

[API](https://skmtc.net/periskope/apis/api-local.md) · [All operations](https://skmtc.net/periskope/apis/api-local/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/periskope/api-local/versions/f2738ced87d8/schema)