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, 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.

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"
}
}
CTRL + M