Skip to main 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": []
  }
]
CTRL + M