I want to Deep link to Viva Engage post draft window with prefilled content

Question

I want to Deep link to Viva Engage post draft window with prefilled content

Prashant Singh 0

I am trying to open the Viva Engage platform right within from our web app to share some links or text message content as a post with the prefilled text or that content which would like to share, but currently I am seeing any option available to pass it.
I am currently opening the viva engage thru the deep links provided by the microsoft, I am linking that document here:
https://learn.microsoft.com/en-us/viva/engage/deeplinks?source=recommendations

Now, I want to pass the content to the web composer once it gets opened, as we have currently one option is there to achieve in Microsoft Teams as mentioned here in this document here:
https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/share-to-teams-from-web-apps?tabs=method1

Please help on this as to how to enable this with viva engage platform(yammer)
Thank you

2 answers

Your answer

Answer 1

Hi Prashant Singh,

Thank you for posting your question in the Microsoft Q&A forum.

After researching your scenario, I found that what you are trying to achieve is not currently supported by Microsoft. There is no officially documented mechanism (whether through URL scheme, Microsoft Graph API, or any SDK) that allows passing content into the Viva Engage composer upon opening.

The reason this differs from the "Share to Teams" experience you referenced is that "Share to Teams" is a purpose-built feature developed by Microsoft specifically for sharing content from external web apps into Teams. It comes with its own JavaScript SDK and dedicated URL endpoints designed to accept content parameters. In contrast, Viva Engage deep links were designed solely for navigation purposes like directing users to existing entities such as threads, communities, storylines, and campaigns. They do not accept any parameters related to message composition or content prefilling.

That said, there are two possible workarounds you could consider:

Workaround 1: Deep Link combined with Clipboard API

You can programmatically copy the desired content to the user's clipboard using the navigator.clipboard.writeText()API, and then open Viva Engage via a deep link (e.g., https://engage.cloud.microsoft/main/groups/<GroupId> or the Teams deep link format). The user would then need to manually paste the content into the composer. The advantage of this approach is that it requires no API permissions or server-side authentication and is straightforward to implement. The downside is that the user experience is suboptimal, as it relies on the user to manually paste the content, and some browsers may restrict clipboard access without a direct user gesture.
Note: This information is provided as a convenience to you. These sites are not controlled by Microsoft, and Microsoft cannot make any representations regarding the quality, safety, or suitability of any software or information found there. Please ensure that you fully understand the risks before using any suggestions from the above link.

Workaround 2: Post directly via the Yammer REST API

You can bypass the composer entirely and post the message directly to Viva Engage using the legacy Yammer REST API endpoint POST https://www.yammer.com/api/v1/messages.json. This allows you to specify the message body, target group, and other parameters programmatically. To mitigate the risk of users not being able to review content before posting, you can implement a preview/confirmation modal within your own web application before making the API call. However, there are important caveats: this approach requires OAuth or Microsoft Entra authentication, and more critically, the legacy Yammer REST APIs using Yammer OAuth2 tokens are set to retire on June 30, 2025. After that date, you must authenticate via Microsoft Entra applications. Additionally, the Microsoft Graph API for Viva Engage does not yet offer an equivalent endpoint for creating posts.

References:

I would also recommend submitting a feature request through the Microsoft Feedback Portal for a "Share to Viva Engage" SDK similar to what exists for Teams, as this appears to be a genuine gap in the platform's capabilities.

Hope this helps.

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.

Prashant Singh 0 Reputation points

2026-02-23T12:46:49.45+00:00

Hi @Kudos-Ng
Thanks for your reply on this request. I would like to know about the legacy REST APIs wether they support the Microsoft Entra applications access tokens or not as Microsoft Graph APIs does to make the api call successfully and also as you mentioned here in your reply that Microsoft Graph API for Viva Engage does not yet offer an equivalent endpoint for creating posts, so on this note, will this legacy REST API to create the post will work or not in the near future if use legacy ones?
Nivedipa-MSFT 3,986 Reputation points Microsoft External Staff Moderator

2026-02-24T05:42:18.8233333+00:00

Hello Prashant Singh - We will check and update you soon.
Kudos-Ng 14,770 Reputation points Microsoft External Staff Moderator

2026-02-24T09:10:01.21+00:00

Hi Prashant Singh,

Thanks for the follow-up question.

Based on the official Microsoft documentation, the legacy Viva Engage (Yammer) v1 REST APIs do support Microsoft Entra ID (Azure AD) access tokens. Microsoft document explicitly states that all Yammer v1 REST endpoints support authentication using Entra tokens.

Regarding the retirement concern: the documentation and Microsoft Tech Community guidance indicate that what’s being retired/restricted is the legacy Yammer OAuth2 application platform / OAuth2-based authentication (legacy Yammer app registrations and token flow) not the Yammer v1 REST endpoints themselves. In other words, if you move to Entra-based authentication, the v1 REST endpoints are still documented as callable.

That said, I did not find any Microsoft document that commits to how long the Yammer v1 REST endpoints will remain available, nor an official retirement date for the endpoints themselves in the materials reviewed. However, because the Microsoft Graph API does not yet offer an equivalent endpoint for creating Viva Engage posts, the Yammer v1 REST API remains the documented option, provided you authenticate using Entra tokens and follow the current guidance.
Prashant Singh 0 Reputation points

2026-02-24T12:25:36.15+00:00

Hi @Kudos-Ng ,
I have one doubt on this POST message API endpoint :
https://learn.microsoft.com/en-us/rest/api/yammer/messages-json-post
while making the api call to this endpoint, if you look at parameters section, its not clear that we can pass group_id and direct_to_user_ids both parameters at the same time or does it support only one parameter either group_id or direct_to_user_ids at a time, so kindly can you please confirm on this?
Kudos-Ng 14,770 Reputation points Microsoft External Staff Moderator

2026-02-24T14:17:53.7466667+00:00

Hi Prashant Singh,

Thank you for the question.

When you are starting a new conversation, the API expects you to specify the posting destination using one of the following parameters: direct_to_user_ids, group_id, or network_id. The documentation states: “To start a new Yammer conversation, specify where the message should be posted using one of direct_to_user_ids, group_id, or network_id.”

Because these parameters represent different destinations (private message vs. community/group vs. network feed), they are intended to be mutually exclusive for a single message creation request.

Additionally, if you are posting a reply to an existing conversation, you should use replied_to_id. The documentation notes that when replied_to_id is set, the target context (such as group/network) is inferred from the message being replied to.
Kudos-Ng 14,770 Reputation points Microsoft External Staff Moderator

2026-02-25T13:02:04.6033333+00:00

Hi Prashant Singh,

Just checking in to see if you had a chance to review the previous response.

Your feedback would be very helpful in ensuring everything is on track.

Answer 2

Prashant Singh 0

Hi @Kudos-Ng

Thanks for your reply on this request. I would like to know about the legacy REST APIs wether they support the Microsoft Entra applications access tokens or not as Microsoft Graph APIs does to make the api call successfully and also as you mentioned here in your reply that Microsoft Graph API for Viva Engage does not yet offer an equivalent endpoint for creating posts, so on this note, will this legacy REST API to create the post will work or not in the near future if use legacy ones?

Prashant Singh 0 Reputation points

2026-02-26T14:02:12.6+00:00

Hi @Kudos-Ng
As you have suggested to submit for a feature request, I have submitted it here
https://feedbackportal.microsoft.com/feedback/idea/a745ddbd-af10-f111-83da-7c1e52ac2057

can you kindly, prioritize this request from you end.

Thank you
Kudos-Ng 14,770 Reputation points Microsoft External Staff Moderator

2026-02-27T15:43:47.33+00:00

Hi Prashant Singh,

Thank you for raising this feedback and for bringing it to my attention.

As much as I would like to help further, I regret to inform you that this is a user‑to‑user support forum. Moderators, contributors, and external Microsoft employees participating here do not have access to backend systems, nor are we involved in or able to manage the feedback portal. Our role is limited to providing technical guidance and sharing best practices based on issues, requests, and ideas reported by users.

That said, the more visibility your feedback receives, the easier it becomes for it to be noticed. You might consider sharing your idea in communities with a large number of developers such as GitHub Discussions to find others who share the same interest and encourage them to visit your feedback post and vote it up.

Thank you again for engaging and contributing to the community.

Share via

I want to Deep link to Viva Engage post draft window with prefilled content

2 answers

Your answer