String. The title of the to-do to add. Ignored if titles is also specified.
titles
String separated by new lines (encoded to %0a). Use instead of title to create multiple to-dos. Takes priority over title and show-quick-entry. The other parameters are applied to all the created to-dos.
notes
String. The text to use for the notes field of the to-do. Maximum unencoded length: 10,000 characters.
when
String. Possible values: today, tomorrow, evening, anytime, someday, a date string, or a date time string. Using a date time string adds a reminder for that time. The time component is ignored if anytime or someday is specified.
Comma separated strings corresponding to the titles of tags. Does not apply a tag if the specified tag doesn’t exist.
checklist-items
String separated by new lines (encoded to %0a). Checklist items to add to the to-do (maximum of 100).
use-clipboard
String. Possible values can be replace-title (newlines overflow into notes, replacing them), replace-notes, or replace-checklist-items (newlines create multiple checklist rows). Takes priority over title, notes, or checklist-items.
list-id
String. The ID of a project or area to add to. Takes precedence over list.
list
String. The title of a project or area to add to. Ignored if list-id is present.
heading
String. The title of a heading within a project to add to. Ignored if a project is not specified, or if the heading doesn't exist.
completed
Boolean. Whether or not the to-do should be set to complete. Default: false. Ignored if canceled is also set to true.
canceled
Boolean. Whether or not the to-do should be set to canceled. Default: false. Takes priority over completed.
show-quick-entry
Boolean. Whether or not to show the quick entry dialog (populated with the provided data) instead of adding a new to-do. Ignored if titles is specified. Default: false.
reveal
Boolean. Whether or not to navigate to and show the newly created to-do. If multiple to-dos have been created, the first one will be shown. Ignored if show-quick-entry is also set to true. Default: false.
ISO8601 date time string. The date to set as the creation date for the to-do in the database. Ignored if the date is in the future.
completion-date
ISO8601 date time string. The date to set as the completion date for the to-do in the database. Ignored if the to-do is not completed or canceled, or if the date is in the future.