Microsoft Planner Integration
Connect Microsoft Planner to Sunsama to browse, import, and sync your tasks.
Bring your Microsoft Planner tasks into your daily plan. Browse your groups, plans and buckets in a panel beside your task list, drag in what you’ll work on today, and update the Planner task without leaving Sunsama.
Installation
Go to Settings > Integrations > Microsoft Planner, or open Microsoft Planner in the right hand panel, and click Add Microsoft Planner account. To connect another Microsoft account, click Add Microsoft Planner account again. To remove an account, click Remove next to it.
The same settings page has an Include your activity from this tool in your Daily Highlights? toggle, and a Reconnect button for each account.
Connecting Planner asks for permission to read your Microsoft 365 groups and their members, so your organization’s admin may need to approve it. See Admin approval / permissions.
Browsing and importing tasks
Open Microsoft Planner in the right hand panel.
Changing Microsoft Planner account
If you’ve connected more than one account, click the avatar in the top right corner of the panel and choose another account.
Viewing groups, plans, and buckets
Microsoft Planner organizes tasks into Microsoft 365 groups, each containing one or more plans, and each plan organized into buckets.
- Click the Group: dropdown at the top of the panel to search and switch between your Microsoft 365 groups. Use Hide private groups or Show private groups in that dropdown to change which groups appear.
- Click the Plan: dropdown to switch between plans in the current group. Two entries are always at the top: My Tasks (tasks assigned to you across plans) and My Day.
- Click the Bucket: dropdown to narrow the list to one bucket, or leave it on All Buckets. Buckets aren’t available in My Tasks or My Day, since those aren’t tied to a single plan.
Viewing task details
Each card shows the task’s checklist progress, priority, due date, and assignee. Click a task to open it. You can update it there, the same way as inside an imported task (see Updating the Planner task from Sunsama).
Importing tasks
When you’re ready to work on a Planner task, pull it into your plan:
- Drag the task from the Microsoft Planner panel onto your task list.
- To timebox it right away, switch to calendar view (
J) and drag the task onto your calendar at the time you’ll work on it. Sunsama adds the task to that day and creates a working session on your calendar. - Click the task and choose Add to today (or hover and press
S), pick another date, or add it to your backlog.
The task’s checklist comes along as Sunsama subtasks.
If a task doesn’t appear in the panel, click Add it by url at the bottom of the panel and paste the task’s Microsoft Planner URL.
Filtering your view
Click Filter to narrow the list:
- Filter by imported: tasks you’ve already imported are hidden by default. Choose Include imported tasks to show them.
- Filter by completion: choose Include completed to show finished tasks.
Click Sort to sort by Due date, or go back to Default.
Interacting with imported tasks
An imported Planner task becomes a Sunsama task linked to the original. Click the Microsoft Planner icon on the task (or hover and press G) to open it in Microsoft Planner.
Updating the Planner task from Sunsama
Open the Sunsama task to see the Planner task inside it. Changes you make there are saved straight to Microsoft Planner. You can:
- Change the progress (Not started, In progress, Completed)
- Change the priority (Urgent, Important, Medium, Low)
- Set or change the start date and due date
- Edit the notes
- Tick or untick checklist items
Assignees, labels and the bucket are shown but are changed in Planner, along with attachments. Planner keeps comments in the group’s Outlook conversation, so read them in Planner. Click the title to open the task there.
The Sunsama task works like a worksheet for the Planner task. Add notes, subtasks, time tracking and comments there without touching the task in Planner.
Understanding synced fields
Completion is the only field that stays in sync, and only from Sunsama to Planner: completing the task in Sunsama completes it in Planner, and un-completing it reopens it. Completing a task in Planner doesn’t complete the linked task in Sunsama. See Automations.
Dates are not synced. The Planner due date isn’t linked to the Sunsama start date or due date, so change it from the preview inside the task.
Keep Microsoft Planner in sync via automations
Open the Microsoft Planner panel and click the Automations tab.
Completion automations
What actions should Sunsama take when you complete an imported task?
Complete in Microsoft Planner
Completing the task in Sunsama also completes it in Microsoft Planner, and un-completing it reopens it. On by default.
Task export to Microsoft Planner
Export a task to Microsoft Planner
Drag and drop a task into your Microsoft Planner panel to export it. This removes the task from Sunsama and creates a task in the plan you’re viewing, in the bucket you’ve selected (or under “No bucket” when the panel shows all buckets). The title, notes, due date, and subtasks (as checklist items) are carried over. Planner notes are plain text, so formatting such as bold and links shows up as Markdown symbols rather than rendered formatting. A Planner task can have at most 20 checklist items, so a task with more subtasks can’t be exported.
Exporting isn’t available while the panel shows My Tasks or My Day, since those are views rather than plans. Choose a plan first.
Copy a task to Microsoft Planner
Hold ⌘ (Mac) or Ctrl (Windows) while you drag to copy the task instead. The task stays in Sunsama, linked to the new Planner task, and the Planner task has a link back to it.
To undo an export, press ⌘ Z (Mac) or Ctrl Z (Windows) within a minute. The first time you export, Sunsama also shows an Undo button.
Sunny and Autoplan
Sunny can read your Planner tasks when you ask about them, for example “what’s due in Planner this week?”. Autoplan also looks at Planner when it drafts your day. To stop Autoplan from using it, open Integrations on the daily planning screen and turn Microsoft 365 off. This also stops Autoplan from using Outlook and Microsoft To Do.
Troubleshooting and FAQ
I don’t see all of my plans
Plans created outside a normal Microsoft 365 group, such as plans from Teams’ personal Tasks app, plans backed by a Loop workspace, or plans surfaced through Microsoft Project, won’t show up under their usual group. Look for a group called My plans (Teams, Loop, personal) in the Group: dropdown, which collects them together.
“Insufficient privileges” or a plan’s tasks all appear missing
If Microsoft Planner reports a permissions error, or a plan you can normally access suddenly shows no tasks, first try disconnecting and reconnecting the integration from Settings > Integrations > Microsoft Planner.
If the preview says Microsoft Planner is turned off for your Microsoft 365 tenant, reconnecting won’t help. Your Microsoft 365 admin has to turn Planner on for your organization.
If reconnecting doesn’t resolve it, contact us at support@sunsama.com. We may ask you to visit a diagnostic link while logged into Sunsama, which returns information about what Microsoft’s API is reporting for your account, so we can pinpoint the cause faster.
Admin approval / permissions
Connecting Microsoft Planner may require approval from your organization’s Microsoft 365 admin. See Troubleshooting: “Need Admin Approval” for the specific permissions Sunsama requests and how to get them approved.