Skip to 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. Possible values are text and html. Default is 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. Possible values are: low, normal, high. Default is 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.
-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 full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

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

Response

Standard 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"
  }
}

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

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