---
title: "Create Workflows webhook handle"
method: POST
path: "/api/v2/integration/ms-teams/configuration/workflows-webhook-handles"
tags: ["Microsoft Teams Integration"]
---

# Create Workflows webhook handle

`POST /api/v2/integration/ms-teams/configuration/workflows-webhook-handles`

Create a Workflows webhook handle in the Datadog Microsoft Teams integration.

## Request body

- MicrosoftTeamsCreateWorkflowsWebhookHandleRequest — Create Workflows webhook handle request.
  - `data` MicrosoftTeamsWorkflowsWebhookHandleRequestData, required — Workflows Webhook handle data from a response.
    - `attributes` MicrosoftTeamsWorkflowsWebhookHandleRequestAttributes, required — Workflows Webhook handle attributes.
      - `name` string, required — Workflows Webhook handle name.
      - `url` string, required — Workflows Webhook URL.
    - `type` 'workflows-webhook-handle', required — Specifies the Workflows webhook handle resource type.

## Response `201`

CREATED

- MicrosoftTeamsWorkflowsWebhookHandleResponse — Response of a Workflows webhook handle.
  - `data` MicrosoftTeamsWorkflowsWebhookHandleResponseData, required — Workflows Webhook handle data from a response.
    - `attributes` MicrosoftTeamsWorkflowsWebhookResponseAttributes — Workflows Webhook handle attributes.
      - `name` string — Workflows Webhook handle name.
    - `id` string — The ID of the Workflows webhook handle.
    - `type` 'workflows-webhook-handle' — Specifies the Workflows webhook handle resource type.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `412` — Failed Precondition
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)