Pinning channel messages (in migration mode)

Question

I am testing the possibility of importing messages from another platform into Teams. I have been following the procedures described here.

If I pin a chat message in migration mode, that works fine; the message appears in a banner at the top of the chat.

However, if I do the same with a channel message (using the channel ID in place of the chat ID), the API call is successful, but there is no indication in the UI that the message is pinned. A call to List pinnedChatMessages in a chat returns the test message's ID.

I could not see a separate API endpoint for pinning channel messages; am I missing something, or is this a known issue?

Answer 1

Hi L

Thank you for reaching out to Microsoft Q&A forum

Based on the behavior you have described, you are not missing anything, and this is a known behavior of the Microsoft Graph API.

Technically, the **POST /chats/{chatId}/pinnedMessages**endpoint, along with its corresponding GET /chats/{chatId}/pinnedMessages(List pinnedChatMessages) endpoint, is scoped exclusively to chat resources, including one-to-one chats, group chats, and meeting chats. It is not designed to work with Teams channels.

As far as I know, there is currently no Microsoft Graph API endpoint in either the v1.0 or beta versions. that supports pinning messages in a Teams channel. The pinning capability visible in the Teams channel UI has not been exposed through Graph API as of this writing.

Until now, the practical approach is to complete the message import migration first, then call the completeMigration endpoint to bring the team and channel out of migration mode. After that, an owner or member with sufficient permissions can manually pin the relevant message through the Teams desktop or web client.

Hope my answer will help you.

---

If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".   

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.