Skip to main content

Configure an Endpoint for Microsoft Teams

Integrate with Microsoft Teams using a custom webhook to receive notifications in your Microsoft Teams workspace.

Adding your Microsoft Teams endpoint

1. Allow firewall access

See Custom Endpoints for general instructions on setting up firewall access for notifications.

This may include whitelisting IPs and/or creating a verification token.

2. Add the endpoint

  1. To add a new custom endpoint, click Add endpoint.
  2. Type: Select the option Custom.
  3. URL: See MS docs for instructions on creating the webhook URL.
  4. Method: Select the POST method.
  5. Headers: Add Content-Type=application/json.
  6. Payload: Add your payload message. See the next step for details.

Configure a custom endpoint

3. Add your payload

Microsoft Teams requires that you send either the text or summary properties. Learn more from Microsoft.

Example payload

To use this example in your own endpoint, copy the payload. Note that double-brackets indicate parameters that will be auto-populated by

"@context": "",
"@type": "MessageCard",
"themeColor": "0072C6",
"title": "{{alert_severity}}: {{alert_title}}",
"summary": "{{alert_description}}",
"text": "{{alert_samples}}",
"potentialAction": [
"@type": "OpenUri",
"name": "View in OpenSearch Dashboards",
"targets": [
"os": "default",
"uri": "{{alert_app_url}}#/view-triggered-alert?from={{alert_timeframe_start_epoch_millis}}&to={{alert_timeframe_end_epoch_millis}}&definitionId={{alert_definition_id}}&switchToAccountId={{account_id}}"

4. Test the endpoint (Optional)

Click Run the test to test your endpoint. shows if the message was successfully sent.

Check that the message arrived at the target endpoint.

5. Save the endpoint

Save your endpoint.