---
title: "Handles Microsoft Teams Bot Framework webhook messages"
method: POST
path: "/teams/messages"
tags: ["teams"]
---

# Handles Microsoft Teams Bot Framework webhook messages

`POST /teams/messages`

This endpoint receives activities from Teams when users message the bot.
It handles message activities and invoke activities (for Adaptive Card actions).

## Request body

- TeamsActivity
  - `attachments` TeamsAttachment[], nullable
    - `content` unknown
    - `contentType` string, required
    - `contentUrl` string, nullable
    - `name` string, nullable
  - `channelId` string, nullable
  - `conversation` TeamsConversationAccount
    - `conversationType` string, nullable
    - `id` string, required
    - `isGroup` boolean, nullable
    - `name` string, nullable
    - `tenantId` string, nullable
  - `from` TeamsChannelAccount
    - `aadObjectId` string, nullable
    - `id` string, required
    - `name` string, nullable
  - `id` string, nullable
  - `recipient` TeamsChannelAccount
    - `aadObjectId` string, nullable
    - `id` string, required
    - `name` string, nullable
  - `replyToId` string, nullable
  - `serviceUrl` string, nullable
  - `text` string, nullable
  - `timestamp` string, nullable
  - `type` 'message' | 'invoke' | 'conversationUpdate' | 'other', required
  - `value` unknown

## Response `200`

Activity processed successfully

- TeamsEventResponse
  - `message` string, nullable
  - `ok` boolean, required

## Changes

- **2026-01-12** `5985f2143fa5` — 1 info
  - endpoint added
- **2026-01-12** `f626a7b6587a` — 1 breaking
  - api path removed without deprecation
- **2026-01-12** `42ca83cab84d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/structifyai/apis/structify/changes/teams/messages/post.md)

---

[API](https://skmtc.dev/structifyai/apis/structify.md) · [All operations](https://skmtc.dev/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/structifyai/structify/revisions/1364930b6980/schema)