---
title: "Set a Microsoft Teams channel-to-project mapping"
method: PUT
path: "/integrations/connections/{connectionId}/microsoft-teams-channel-project-mappings/{microsoftTeamsChannelId}"
tags: ["Integrations"]
---

# Set a Microsoft Teams channel-to-project mapping

`PUT /integrations/connections/{connectionId}/microsoft-teams-channel-project-mappings/{microsoftTeamsChannelId}`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/integrations/connections/{connectionId}/microsoft-teams-channel-project-mappings/{microsoftTeamsChannelId}`
- Auth: none declared

Create or update the mention route of one Teams channel. The channel name and team are resolved from the connection's channel catalog. Idempotent on (connection, channel).

## Path parameters

- `connectionId` string, uuid, required: Microsoft Teams integration connection ID (the `integration_connections.id`).
- `microsoftTeamsChannelId` string, required: Teams channel ID (e.g. 19:abc123@thread.tacv2). Must be in the connection's channel catalog.

## Request body

- object
  - `organizationId` string: Organization the connection belongs to. Auto-filled from CLI and SDK context when omitted.
  - `projectId` string, uuid, required: Project the channel routes to. Must belong to the organization.

## Response `200`

OK

- object
  - `connectionId` string, uuid, required
  - `microsoftTeamsChannelId` string, required: Teams channel ID (e.g. 19:abc123@thread.tacv2).
  - `microsoftTeamsChannelName` string, required: The channel's name, as the connection's channel catalog names it.
  - `microsoftTeamsTeamId` string, nullable, required: The team the channel belongs to, when the catalog names one.
  - `projectId` string, uuid, required

## Changes

- **2026-10-12** `b534c363fdf8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/integrations/connections/:connectionId/microsoft-teams-channel-project-mappings/:microsoftTeamsChannelId/put.md)

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/965b6230cf45?raw)