title- 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.
deadline- Date string. The deadline to apply to the to-do.
tags- 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.
list- String. The name of the list of a project or area to add to. You must enter the lists you wish to use in the list settings and save.
list- Array of String. Enter each list name from things. One per row and click save. These will be saved and then shows in the menu above
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.
creation-dateauth-token- String. The Things URL scheme authorization token.
- 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.