> For the complete documentation index, see [llms.txt](https://support.whapi.cloud/help-desk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.whapi.cloud/help-desk/groups/send-group-message/mentioning-all-participants-in-a-whatsapp-group.md).

# Mentioning all participants in a WhatsApp group

How to Mention all numbers in a Group when sending a message

Mentioning in messaging apps allows you to specifically notify one or more participants in a group chat by using the "@" symbol followed by their username or phone number. This feature ensures that the mentioned individuals receive a notification, drawing their attention to the message. This is particularly useful in group settings where messages can be numerous, and important updates need to be highlighted for specific members.

The endpoint for sending messages allows you to compose and send messages to individuals or groups. One of the parameters in this endpoint, mentions, is particularly important when you want to notify specific users within a group.

[Send text message](/help-desk/sending/send-text-message.md)

For a detailed explanation of the message sending process, please refer to our article on sending messages. Here, we will focus on the mentions parameter.

#### Mentioning All Participants in a WhatsApp Group

To mention (tag) all group participants, write `@all` in the message text and pass `"all"` in the `mentions` parameter. You don't need to list the participants' numbers.

```url
curl --request POST \
     --url https://gate.whapi.cloud/messages/text \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_TOKEN' \
     --header 'content-type: application/json' \
     --data '
{
  "to": "120363282930441732@g.us",
  "body": "Hello @all",
  "mentions": ["all"]
}
'
```

You can mention everyone and specific participants in one message:

```json
{
  "to": "120363282930441732@g.us",
  "body": "Hello @all! @14046542567, how are you?",
  "mentions": ["all", "14046542567"]
}
```

`@all` also works in a media caption: pass `@all` in `caption` and `"all"` in `mentions`, for example in [Send image message](https://whapi.readme.io/reference/sendmessageimage).

Incoming and outgoing webhooks of such a message contain `"context": {"mention_all": true}`. Example of an incoming webhook:

```json
{
  "messages": [
    {
      "id": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "from_me": false,
      "type": "text",
      "source": "web",
      "chat_id": "120363000000000000@g.us",
      "from": "15550000000",
      "text": {
        "body": "@all 123"
      },
      "context": {
        "mention_all": true
      },
      "from_name": "User"
    }
  ],
  "event": {
    "type": "messages",
    "event": "post"
  },
  "channel_id": "XXXXX-XXXXX"
}
```

#### Mentioning specific participants

To mention a group participant, pass their phone number or LID in the `mentions` array. In `body`, write `@` followed by the same phone number or the numeric part of the LID.

```json
{
  "to": "120363000000000000@g.us",
  "body": "Hey @99621883932815, please check this",
  "mentions": ["99621883932815@lid"]
}
```

This example uses a LID. For a phone number, use `"mentions": ["14046542567"]` and `@14046542567` in the text.

The identifier must belong to a participant in the group. Both the `@` mention in the text and the `mentions` array are required.

**Fetching Group Members:** Retrieve the group members' identifiers and pass those of the participants you want to mention in the `mentions` parameter.

[Get list of group members](/help-desk/groups/get-list-of-group-members.md)

***

**Need Assistance?**

If you need any help with setting up or using the mentions feature, our support team is always available via live chat on any dashboard page or via email at [care@whapi.cloud](mailto:undefined)