Planner tasks and plans API overview

Planner provides a simple and visual way for teams to organize their work. Customers can use Planner to create plans, organize and assign tasks, share progress, and collaborate on content. Planner provides several interactive experiences including a task board, a charts page, and a schedule view, as well as integrations throughout Office 365.

Office 365 Planner task board

Screenshot of an Office 365 Planner task board

Why integrate with Planner tasks?

Planner provides task tracking capabilities for collaboration experiences in Office 365. If your scenarios require tracking tasks and organizing work for a team or group of end users, Planner is the right service for you. Planner integration can help you reach the millions of users collaborating on Office 365.

Organize your team’s work

Planner provides a shared space where you can build a team, create tasks, and assign them to others on the team. Planner makes it easy for everyone to know who’s doing what and if things are on track. You can update tasks with additional information like due dates, progress, and descriptions, and then further organize tasks with customizable buckets and category labels.

Collaborate across Office 365

Planner integrates into collaboration experiences across Office 365. In addition to Planner web and mobile clients, users can view and update Planner plans and tasks from within SharePoint and Microsoft Teams.

Planner itself is also powered by the Microsoft Graph and the Office 365 group service. Files that you upload and attach to Planner tasks are stored in SharePoint. Planner comments are based on Outlook group conversations.

Automate the creation of plans and tasks

Are you working on repeated process or project type? You can use the Planner API to automate the creation of a plan and a list of tasks.

Top Planner API tasks

Operation URL
See all the plans for a group GET https://graph.microsoft.com/v1.0/groups/{id}/planner/plans
See tasks in a plan GET https://graph.microsoft.com/v1.0/planner/plans/{id}/tasks
See all my tasks assigned to me across plans GET https://graph.microsoft.com/v1.0/me/planner/tasks/
Create a new task POST https://graph.microsoft.com/v1.0/planner/tasks
Update a task PATCH https://graph.microsoft.com/v1.0/planner/tasks/{task-id}
Delete a task DELETE https://graph.microsoft.com/v1.0/planner/tasks/{id}

API reference

Looking for the API reference for this service?

Next steps