---
title: "Create Ms Team Link Conversation"
method: POST
path: "/api/integration/ms-team/link-conversation"
tags: ["Integration"]
---

# Create Ms Team Link Conversation

`POST /api/integration/ms-team/link-conversation`

Create Microsoft Teams link conversation with bot.

## Request body

- ConversationSchema — Schema for representing a conversation.
  - `bot_id` string, uuid, nullable — Optional identifier for the associated bot.
  - `conversation_id` string, uuid, nullable — Optional identifier for the conversation.

## Response `200`

Successful Response

- ConversationResponseSchema — Schema for representing a response to a conversation.
  - `bot_id` string, uuid, nullable — Optional identifier for the associated bot.
  - `conversation_id` string, uuid, nullable — Optional identifier for the conversation.
  - `id` string, uuid, nullable — Optional identifier for the response.
  - `created_at` string, date-time, nullable — Optional timestamp indicating the creation time.
  - `updated_at` string, date-time, nullable — Optional timestamp indicating the last update time.

## Other responses

- `422` — Validation Error

## Changes

> 3 revisions in range; 1 not diffed.

- **2023-11-08** `dbd91277da05` — 2 breaking, 4 info
  - the request property `bot_id` became required
  - the request property `conversation_id` became required
  - api operation id `create_ms_team_link_conversation_api_integration_ms_team_link_conversation_post` removed and replaced with `create_link_conversation_api_integration_ms_team_link_conversation_post`
  - the response property `bot_id` became required for the status `200`
  - …2 more

[Change history](https://skmtc.dev/chat-fly/apis/chatfly-backend-application/changes/api/integration/ms-team/link-conversation/post.md)

---

[API](https://skmtc.dev/chat-fly/apis/chatfly-backend-application.md) · [All operations](https://skmtc.dev/chat-fly/apis/chatfly-backend-application/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chat-fly/chatfly-backend-application/revisions/cbb37496f138/schema)