Skip to main content

todo task add

Adds a task to a Microsoft To Do list

Usage​

m365 todo task add [options]

Options​

-t, --title <title>

The title of the task.

--listName [listName]

The name of the list in which to create the task. Specify either listName or listId, but not both.

--listId [listId]

The id of the list in which to create the task. Specify either listName or listId, but not both.

--bodyContent [bodyContent]

The body content of the task. In the UI this is called 'notes'.

--bodyContentType [bodyContentType]

The type of the body content. Allowed values: text and html. Defaults to text.

--dueDateTime [dueDateTime]

The date when the task is due. This should be defined as a valid ISO 8601 string in the UTC time zone. Only date value is needed, time value is always ignored.

--importance [importance]

The importance of the task. Allowed values: low, normal, high. Defaults to normal.

--reminderDateTime [reminderDateTime]

The date and time for a reminder alert of the task to occur. This should be defined as a valid ISO 8601 string in the UTC time zone.

--categories [categories]

Comma-separated list of categories associated with the task.

--completedDateTime [completedDateTime]

The date and time when the task was finished. This should be defined as a valid ISO 8601 string. 2021-12-16T18:28:48.6964197Z. This option can only be used when the status is set to completed.

--startDateTime [startDateTime]

The date and time when the task is scheduled to start. This should be defined as a valid ISO 8601 string. e.g. 2021-12-16T18:28:48.6964197Z.

--status [status]

Indicates the state or progress of the task. Allowed values: notStarted, inProgress, completed, waitingOnOthers, deferred.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

When you specify the values for categories, each category can correspond to the displayName property of an outlookCategory. It is permissible to use distinct names.

Permissions​

ResourcePermissions
Microsoft GraphTasks.ReadWrite

Examples​

Add a task to Microsoft To Do tasks list with with a specific name.

m365 todo task add --title "New task" --listName "My task list"

Add a task to a Microsoft To Do tasks list with a specific id.

m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA=="

Create a new task with bodyContent and reminder and flag it as important.

m365 todo task add --title "New task" --listName "My task list" --bodyContent "I should not forget this" --reminderDateTime 2023-01-01T12:00:00Z --importance high

Create a new task with a specific due date.

m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01

Create a new task with categories, a completedDateTime, a startDateTime and a status.

m365 todo task add --title "New task" --listName "My task list" --categories "Red category,Important" --completedDateTime 2023-12-01 --startDateTime 2023-12-01 --status "notStarted"

Response​

{
  "importance": "high",
  "isReminderOn": true,
  "status": "notStarted",
  "title": "New task",
  "createdDateTime": "2022-10-29T10:54:06.3672421Z",
  "lastModifiedDateTime": "2022-10-29T10:54:06.5078837Z",
  "hasAttachments": false,
  "categories": [],
  "id": "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=",
  "body": {
    "content": "I should not forget this",
    "contentType": "text"
  },
  "dueDateTime": {
    "dateTime": "2023-01-01T00:00:00.0000000",
    "timeZone": "UTC"
  },
  "reminderDateTime": {
    "dateTime": "2023-01-01T12:00:00.0000000",
    "timeZone": "UTC"
  }
}