Create plan

Use this API to create a new plan.

Note that you need to have created a group and be a member of it before you can make the group an owner of the plan. Read the overview to understand the relationship between group, plan and task.

Prerequisites

One of the following scopes is required to execute this API:

Group.ReadWrite.All

HTTP request

POST /plans

Request headers

Name Type Description
Authorization string Value should be set to "Bearer (access-token)"

Request body

In the request body, supply a JSON representation of plan object.

Response

If successful, this method returns 201, Created response code and plan object in the response body.

Example

Request

Here is an example of the request.

POST https://graph.microsoft.com/beta/plans
Content-type: application/json
Content-length: 88

{
  "owner": "owner-value",
  "title": "title-value"
}

In the request body, supply a JSON representation of plan object.

Response

Here is an example of the response.

HTTP/1.1 201 Created
Content-type: application/json
Content-length: 108

{
  "createdBy": "createdBy-value",
  "owner": "owner-value",
  "title": "title-value",
  "id": "id-value"
}