Tasks & My Day
createTodo
Create To-do
Create a Task: a to-do item in a task list.
Arguments
textstringrequiredThe task title: one line. Put longer detail in note.notestringoptionalThe SHARED note: the task's description body. Everyone with access to the task or its list reads it, and a public task link renders it. Write here only what the user meant everyone to see. The title stays in text.privateNotestringoptionalThe PRIVATE note. The task's owner alone ever reads it: it is stripped from every read that reaches anyone else and from every shared-link payload, and sharing the task never promotes it. This is the DEFAULT home for a note you author…listIdstringoptionalThe ID of the target task list. Call listTaskLists first to get available lists and choose the best match. Omit to add to My Tasks.prioritystringoptionalPriority level of the tododueDatestringoptionalDue date in ISO format (optional)statusIdstringoptionalWorkflow status IDprojectIdstringoptionalCloud Project ID, from listProjects or createProjectparentIdstringoptionalParent Task IDlabelIdsstring[]optionalTask label IDsassigneeIdsstring[]optionalSpace member user IDs
Returns
Returns the todoId and canonical Task URL.
Declared limits
text: minimum length 1
Ask for it
The Cloud routes these requests to this verb.
- add a task
- remind me to
- I need to
- to-do
Pair it with
The verbs that finish the job.