Skip to content

teams message list

Lists all messages from a channel in a Microsoft Teams team

Usage

m365 teams message list [options]

Options

-i, --teamId <teamId>
The ID of the team where the channel is located
-c, --channelId <channelId>
The ID of the channel for which to list messages
-s, --since [since]
Date (ISO standard, dash separator) to get delta of messages from (in last 8 months)
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Remarks

You can only retrieve a message from a Microsoft Teams team if you are a member of that team.

Examples

List the messages from a channel of the Microsoft Teams team

m365 teams message list --teamId fce9e580-8bba-4638-ab5c-ab40016651e3 --channelId 19:eb30973b42a847a2a1df92d91e37c76a@thread.skype

List the messages from a channel of the Microsoft Teams team that have been created or modified since the date specified by the --since parameter (WARNING: only captures the last 8 months of data)

m365 teams message list --teamId fce9e580-8bba-4638-ab5c-ab40016651e3 --channelId 19:eb30973b42a847a2a1df92d91e37c76a@thread.skype --since 2019-12-31T14:00:00Z

Response

[
  {
    "id": "1666799217259",
    "replyToId": null,
    "etag": "1666799649208",
    "messageType": "message",
    "createdDateTime": "2022-10-26T15:46:57.259Z",
    "lastModifiedDateTime": "2022-10-26T15:54:09.208Z",
    "lastEditedDateTime": "2022-10-26T15:54:09.108Z",
    "deletedDateTime": null,
    "subject": "",
    "summary": null,
    "chatId": null,
    "importance": "normal",
    "locale": "en-us",
    "webUrl": "https://teams.microsoft.com/l/message/19%3eb30973b42a847a2a1df92d91e37c76a%40thread.tacv2/1666799217259?groupId=fce9e580-8bba-4638-ab5c-ab40016651e3&tenantId=92e59666-257b-49c3-b1fa-1bae8107f6ba&createdTime=1666799217259&parentMessageId=1666799217259",
    "policyViolation": null,
    "eventDetail": null,
    "from": {
      "application": null,
      "device": null,
      "user": {
        "id": "78ccf530-bbf0-47e4-aae6-da5f8c6fb142",
        "displayName": "John Doe",
        "userIdentityType": "aadUser",
        "tenantId": "92e59666-257b-49c3-b1fa-1bae8107f6ba"
      }
    },
    "body": {
      "contentType": "text",
      "content": "First message!"
    },
    "channelIdentity": {
      "teamId": "fce9e580-8bba-4638-ab5c-ab40016651e3",
      "channelId": "19:e2916df2b11046beba42d22da898383f@thread.tacv2"
    },
    "attachments": [],
    "mentions": [],
    "reactions": []
  }
]    
id             summary  body
-------------  -------  ---------------
1666799217259  null     First message!
id,summary,body
1666799217259,,First message!