Planner tasks and plans API overview

The Planner API in Microsoft Graph 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 Microsoft 365.

Microsoft 365 Planner task board

Screenshot of a Microsoft 365 Planner task board

Why integrate with Planner tasks?

Planner provides task tracking capabilities for collaboration experiences in Microsoft 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 Microsoft 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 Microsoft 365

Planner integrates into collaboration experiences across Microsoft 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 Microsoft 365 group service. Files that you upload and attach to Planner tasks are stored in SharePoint. Planner comments are based on Outlook group conversations.

Business scenario support

Planner supports business scenarios. Using the business scenarios API, you can create tasks and plans for your business processes, and control the tasks and the user experience around these tasks from the scenario configuration. Learn more about business scenarios.

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