This post was most recently updated on November 30th, 2022.
2 min read.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!
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, here is the solution:
Time needed: 5 minutes
Forming links for Microsoft Planner 365
- You can 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? - 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 - 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.
https://tasks.office.com/yourorganization.onmicrosoft.com/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.
And there you go!
He's been a developer from 2004 (starting with PHP and Java), and he's been working on .NET projects, Azure, Office 365, SharePoint and a lot of other stuff. He's also Microsoft MVP for Azure.
This is his personal professional (e.g. professional, but definitely personal) blog.
- Don’t assign root domain to GitHub Pages if you use it for email! - January 14, 2025
- Experiences from migrating to Bitwarden - January 7, 2025
- 2024 Year Review – and 20 years in business! - December 31, 2024
