Office 365 Planner logo

How to form links to Planner tasks

Office 365 Planner is a neat tool for task management. However, when you, for whatever use case, need to form urls that point you towards a single task (or a bucket, or a plan for that matter), you might run into trouble with how the url is formed. Custom domains actually make it a bit complicated, but luckily there’s a workaround!

Description of the issue

If you have multiple domains in your Azure AD, your Planner might end up using your custom domain in its urls. However, if you need to develop some multi-tenant code, that works with any tenant and whatever weird custom domains, you’d have to actually either create another user-supplied property (for the custom domain), or develop some creative extra code to fetch the domains from somewhere… Since the Graph API for Planner certainly does NOT return that!

No worries – you don’t actually need to develop any complicated or smart code. It’s actually WAY easier than that! 

Solution

So – Graph API does not return any urls for Plans, Planner or any Tasks you might get from the API. That might complicate any custom functionality you’d maybe want to create… But you can just access Planner to see the urls (see the picture below), and if need be, take note of the custom domain included!

Selecting Planner from the waffle (see the custom domain in the url!)
Selecting Planner from the waffle (see the custom domain in the url!)

This should help us figure out, how the urls are constructed. Let’s see…

Now, links to single tasks will be like this:

https://tasks.office.com/customdomain.com/EN-US/Home/Planner#/plantaskboard?groupId=2dcc6885-53d4-4506-a040-063cbc7dcc80&planId=9KHxgT0X-0ebDNk_M5AnKpYAFl8e&taskId=WdU82Alj40-K1yFuECbKoZYAADDq

Pretty horrible, right? No worries, though! You can also create short links, like this:

https://tasks.office.com/customdomain.com/en-us/Home/Task/WdU82Alj40-K1yFuECbKoZYAADDq

That’s a lot better, right? But we STILL have that darn custom domain there! What can we do about it?

Ah – it’s actually simple. Just replace the custom domain with your built-in cloud domain, like this:

https://tasks.office.com/yourorganization.onmicrosoft.com/en-us/Home/Task/WdU82Alj40-K1yFuECbKoZYAADDq

And there you go! According to my testing, it seems like the task ids are always unique, and even with the built-in domain Planner will handle redirections just fine by itself.

If you want to make it even simpler, you can also remove the “en-us” from the url, and Planner will just figure out which locale to use itself.

The following two tabs change content below.

Antti K. Koskela

Solutions Architect / Escalations Engineer at Koskila / Norppandalotti Software / Valo Solutions
Antti Koskela is a proud digital native nomadic millenial full stack developer (is that enough funny buzzwords? That's definitely enough funny buzzwords!), who works as a Solutions Architect for Valo Intranet, the product that will make you fall in love with your intranet. Working with the global partner network, he's responsible for the success of Valo deployments happening all around the world. He's been a developer from 2004 (starting with PHP and Java), and he's been bending and twisting SharePoint into different shapes since MOSS. Nowadays he's not only working on SharePoint, but also on .NET projects, Azure, Office 365 and a lot of other stuff. This is his personal professional (e.g. professional, but definitely personal) blog.

Let me know your thoughts!