Todoist¶

Node: todoist · Full type: n8n-nodes-base.todoist · Version: 2.2

Credentials¶

todoistApi (alias: @todoist) / todoistOAuth2Api (alias: @todoist)

CREDENTIAL @todoist = todoistApi "My Todoist"

Operations¶

Resource: `task`¶

`close`¶

Parameter	Type	Default	Details
`taskId`	string	""	required

`create`¶

Parameter	Type	Default	Details
`project`	resourceLocator	{...}	required; modes: `list`, `id`
`labels`	multiOptions	[]
`content`	string	""	required
`options`	collection	{}	keys: `description`, `dueDateTime`, `dueLang`, `dueString`, `parentId`, `priority`, ...

`delete`¶

Parameter	Type	Default	Details
`taskId`	string	""	required

`get`¶

Parameter	Type	Default	Details
`taskId`	string	""	required

`getAll`¶

Parameter	Type	Default	Details
`returnAll`	boolean	false
`limit`	number	50
`filters`	collection	{}	keys: `filter`, `ids`, `labelId`, `lang`, `parentId`, `projectId`, ...

`move`¶

Parameter	Type	Default	Details
`taskId`	string	""	required
`project`	resourceLocator	{...}	required; modes: `list`, `id`
`section`	options	""
`options`	collection	{}	keys: `section`, `parent`

`quickAdd`¶

Parameter	Type	Default	Details
`text`	string	""	required
`options`	collection	{}	keys: `note`, `reminder`, `auto_reminder`

`reopen`¶

Parameter	Type	Default	Details
`taskId`	string	""	required

`update`¶

Parameter	Type	Default	Details
`taskId`	string	""	required
`updateFields`	collection	{}	keys: `content`, `description`, `dueDateTime`, `dueLang`, `dueString`, `dueLang`, ...

Resource: `project`¶

`archive`¶

Parameter	Type	Default	Details
`projectId`	string	""	required

`create`¶

Parameter	Type	Default	Details
`name`	string	""	required
`projectOptions`	collection	{}	keys: `color`, `is_favorite`, `parent_id`, `view_style`

`delete`¶

Parameter	Type	Default	Details
`projectId`	string	""	required

`get`¶

Parameter	Type	Default	Details
`projectId`	string	""	required

`getCollaborators`¶

Parameter	Type	Default	Details
`projectId`	string	""	required

`getAll`¶

No additional parameters.

`unarchive`¶

Parameter	Type	Default	Details
`projectId`	string	""	required

`update`¶

Parameter	Type	Default	Details
`projectId`	string	""	required
`projectUpdateFields`	collection	{}	keys: `name`, `color`, `is_favorite`, `view_style`

Resource: `section`¶

`create`¶

Parameter	Type	Default	Details
`sectionProject`	resourceLocator	{...}	required; modes: `list`, `id`
`sectionName`	string	""	required
`sectionOptions`	collection	{}	keys: `order`

`delete`¶

Parameter	Type	Default	Details
`sectionId`	string	""	required

`get`¶

Parameter	Type	Default	Details
`sectionId`	string	""	required

`getAll`¶

Parameter	Type	Default	Details
`sectionFilters`	collection	{}	keys: `project_id`

`update`¶

Parameter	Type	Default	Details
`sectionId`	string	""	required
`sectionUpdateFields`	collection	{}	keys: `name`

Resource: `comment`¶

`create`¶

Parameter	Type	Default	Details
`commentTaskId`	string	""	required
`commentContent`	string	""	required

`delete`¶

Parameter	Type	Default	Details
`commentId`	string	""	required

`get`¶

Parameter	Type	Default	Details
`commentId`	string	""	required

`getAll`¶

Parameter	Type	Default	Details
`commentFilters`	collection	{}	keys: `task_id`, `project_id`

`update`¶

Parameter	Type	Default	Details
`commentId`	string	""	required
`commentUpdateFields`	collection	{}	keys: `content`

Resource: `label`¶

`create`¶

Parameter	Type	Default	Details
`labelName`	string	""	required
`labelOptions`	collection	{}	keys: `color`, `order`, `is_favorite`

`delete`¶

Parameter	Type	Default	Details
`labelId`	string	""	required

`get`¶

Parameter	Type	Default	Details
`labelId`	string	""	required

`getAll`¶

No additional parameters.

`update`¶

Parameter	Type	Default	Details
`labelId`	string	""	required
`labelUpdateFields`	collection	{}	keys: `name`, `color`, `order`, `is_favorite`

Resource: `reminder`¶

`create`¶

Parameter	Type	Default	Details
`itemId`	string	""	required
`dueDateType`	options	"natural_language"	required; `natural_language`, `full_day`, `floating_time`, `fixed_timezone`
`natural_language_representation`	string	""	required
`date`	string	""	required
`datetime`	dateTime	""	required
`datetime`	dateTime	""	required
`timezone`	string	""	required
`reminderOptions`	collection	{}	keys: `type`, `minute_offset`, `notify_uid`

`delete`¶

Parameter	Type	Default	Details
`reminderId`	string	""	required

`getAll`¶

No additional parameters.

`update`¶

Parameter	Type	Default	Details
`reminderId`	string	""	required
`reminderUpdateFields`	collection	{}	keys: `due`, `type`, `minute_offset`, `notify_uid`

Common Parameters¶

Parameter	Type	Default	Details
`authentication`	options	"apiKey"	`apiKey`, `oAuth2`

Parameter Details¶

updateFields children:

Parameter	Type	Default	Details
`content`	string	""
`description`	string	""
`dueDateTime`	dateTime	""
`dueLang`	string	""
`dueString`	string	""
`dueLang`	string	""
`labels`	multiOptions	[]
`priority`	number	1
`order`	number	0
`dueDate`	string	""
`assigneeId`	string	""
`duration`	number	0
`durationUnit`	options	"minute"	`minute`, `day`
`deadlineDate`	string	""

options children:

Parameter	Type	Default	Details
`section`	options	""
`parent`	options	""

filters children:

Parameter	Type	Default
`filter`	string	""
`ids`	string	""
`labelId`	options	{}
`lang`	string	""
`parentId`	options	""
`projectId`	options	""
`sectionId`	options	""

projectUpdateFields children:

Parameter	Type	Default	Details
`name`	string	""
`color`	options	""	`berry_red`, `red`, `orange`, `yellow`, `olive_green`, `lime_green`, `green`, `mint_green`, ... (20 total)
`is_favorite`	boolean	false
`view_style`	options	"list"	`list`, `board`

projectOptions children:

Parameter	Type	Default	Details
`color`	options	""	`berry_red`, `red`, `orange`, `yellow`, `olive_green`, `lime_green`, `green`, `mint_green`, ... (20 total)
`is_favorite`	boolean	false
`parent_id`	string	""
`view_style`	options	"list"	`list`, `board`

sectionUpdateFields children:

Parameter	Type	Default	Details
`name`	string	""

sectionOptions children:

Parameter	Type	Default	Details
`order`	number	0

sectionFilters children:

Parameter	Type	Default	Details
`project_id`	options	""

commentUpdateFields children:

Parameter	Type	Default	Details
`content`	string	""

commentFilters children:

Parameter	Type	Default	Details
`task_id`	string	""
`project_id`	string	""

labelUpdateFields children:

Parameter	Type	Default	Details
`name`	string	""
`color`	options	""	`berry_red`, `red`, `orange`, `yellow`, `olive_green`, `lime_green`, `green`, `mint_green`, ... (20 total)
`order`	number	0
`is_favorite`	boolean	false

labelOptions children:

Parameter	Type	Default	Details
`color`	options	""	`berry_red`, `red`, `orange`, `yellow`, `olive_green`, `lime_green`, `green`, `mint_green`, ... (20 total)
`order`	number	0
`is_favorite`	boolean	false

reminderUpdateFields children:

Parameter	Type	Default	Details
`due`	collection	{}	keys: `string`, `date`, `datetime`, `timezone`
`type`	options	"absolute"	`absolute`, `relative`
`minute_offset`	number	0
`notify_uid`	string	""

reminderOptions children:

Parameter	Type	Default	Details
`type`	options	"absolute"	`absolute`, `relative`
`minute_offset`	number	0
`notify_uid`	string	""

Example¶

NODE "todoist" @todoist AS "Todoist" {
  resource: "task",
  operation: "get",
  taskId: {{ $json.taskId }},
  content: {{ $json.content }},
  text: {{ $json.text }}
}

Todoist¶

Credentials¶

Operations¶

Resource: task¶

close¶

create¶

delete¶

get¶

getAll¶

move¶

quickAdd¶

reopen¶

update¶

Resource: project¶

archive¶

create¶

delete¶

get¶

getCollaborators¶

getAll¶

unarchive¶

update¶

Resource: section¶

create¶

delete¶

get¶

getAll¶

update¶

Resource: comment¶

create¶

delete¶

get¶

getAll¶

update¶

Resource: label¶

create¶

delete¶

get¶

getAll¶

update¶

Resource: reminder¶

create¶

delete¶

getAll¶

update¶

Common Parameters¶

Parameter Details¶

Example¶

Resource: `task`¶

`close`¶

`create`¶

`delete`¶

`get`¶

`getAll`¶

`move`¶

`quickAdd`¶

`reopen`¶

`update`¶

Resource: `project`¶

`archive`¶

`create`¶

`delete`¶

`get`¶

`getCollaborators`¶

`getAll`¶

`unarchive`¶

`update`¶

Resource: `section`¶

`create`¶

`delete`¶

`get`¶

`getAll`¶

`update`¶

Resource: `comment`¶

`create`¶

`delete`¶

`get`¶

`getAll`¶

`update`¶

Resource: `label`¶

`create`¶

`delete`¶

`get`¶

`getAll`¶

`update`¶

Resource: `reminder`¶

`create`¶

`delete`¶

`getAll`¶

`update`¶