Reply to Channel Message

Reply to Channel Message

Send a reply to a specific message in a channel within a Microsoft Teams team.

API Details

• API Name: Microsoft Teams API
• OpenAPI Ref: ../​../​openapi/​microsoft-teams-openapi.yaml
• Endpoint: POST /​teams/​{team-id}/​channels/​{channel-id}/​messages/​{message-id}/​replies
• Operation ID: replyToChannelMessage
• Tag: ChatMessages

Sandbox

• Base URL: http://localhost:8080/​rest/​microsoft-teams-api/​1.0.0

Required Headers

• Authorization: Bearer {access_token}
• Content-Type: application/​json

OAuth Scopes

• ChannelMessage.Send

Parameters

Path Parameters

Request Body

Example Request

curl -X POST "http://localhost:8080/​rest/​microsoft-teams-api/​1.0.0/​teams/​{team-id}/​channels/​{channel-id}/​messages/​{message-id}/​replies" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/​json" \
  -d '{
    "body": {
      "contentType": "text",
      "content": "Sounds good, I will prepare the update."
    }
  }'

Example Response

{
  "id": "msg-001",
  "messageType": "message",
  "createdDateTime": "2025-01-20T14:30:00Z",
  "subject": null,
  "body": {
    "contentType": "text",
    "content": "Sounds good, I will prepare the update."
  },
  "from": {
    "user": {
      "id": "user-001",
      "displayName": "Jane Smith"
    }
  },
  "importance": "normal",
  "attachments": [],
  "mentions": []
}

Status Code: 201 Created

Instructions

1. Obtain a valid access token with the ChannelMessage.Send scope.
2. Identify the team ID, channel ID, and message ID for the message you want to reply to.
3. Construct the request body with the reply content and content type.
4. Send a POST request to the /​teams/​{team-id}/​channels/​{channel-id}/​messages/​{message-id}/​replies endpoint.
5. Optionally include mentions, attachments, or set the importance level.
6. A successful request returns a 201 status code with the created reply message object.