How To Mention Someone In Microsoft Teams Webhook

How To Articles

Being a frequent user of Microsoft Teams, I recognize the significance of proficient communication and collaboration within the platform. A notable aspect in Microsoft Teams is the capability to refer to someone in a webhook message, which can guarantee that vital notifications are not overlooked. In this article, I will walk you through the steps of mentioning someone in a Microsoft Teams webhook with comprehensive instructions and my own remarks.

Before we dive into the specifics, let’s first understand what a webhook is. In simple terms, a webhook is a way for an application to send real-time notifications to another application. In the case of Microsoft Teams, a webhook can be used to send messages and notifications to a channel or directly to a person.

To mention someone in a Microsoft Teams webhook, follow these steps:

  1. First, you need to have the appropriate permissions to create and manage webhooks in Microsoft Teams. If you don’t have these permissions, reach out to your IT administrator to request access.
  2. Next, navigate to the channel or chat where you want to mention someone in the webhook message.
  3. Click on the three dots (…) next to the channel or chat name, and select “Connectors” from the dropdown menu.
  4. In the Connectors window, search for “Incoming Webhook” and click on it.
  5. Click on the “Add” button to create a new webhook.
  6. Give your webhook a name and an optional image, and click on the “Create” button.
  7. Copy the generated webhook URL, as you will need it to send messages later.
  8. Now, to mention someone in the webhook message, you need to include their mention in the message payload. The payload is a JSON object that contains the message content and other optional properties.
  9. In the payload, include the following code snippet to mention someone:

"text": "Hello <at>[person's mention]

Note that you need to replace “[person’s mention]” with the actual mention of the person you want to mention. The mention should be in the format of “@mention”.

For example, if you want to mention a person with the username “john.doe”, your payload would look like this:

"text": "Hello <at>@john.doe"

Once you have prepared the payload with the person’s mention, you can send the webhook message using the generated webhook URL. You can use any programming language or tool that supports making HTTP requests.

After sending the webhook message, the person you mentioned will receive a notification in their Microsoft Teams client, indicating that they have been mentioned in a message.


Mentioning someone in a Microsoft Teams webhook message is a powerful way to grab their attention and ensure that important notifications are not missed. By following the steps outlined in this article, you can easily include mentions in your webhook messages and enhance your team’s communication and collaboration. Give it a try and see how it improves your productivity in Microsoft Teams!