Connectors Reference

Todoist

Todoist is an online task management app and todo list. With Todoist, users can organize, schedule, maintain and prioritize personal tasks.

 

Status: Production

Tier: Standard

Version: 1.1

 

Actions:

Name

Summary

ListProjects ()

List projects

ListItems ()

List tasks

ListItemsByProject (string id)

List tasks by project

ListLabels ()

List labels

CreateItem (string project_id, CreateItemParameterNewItem newItem)

Create a task

UpdateItem (string id, string item_id, UpdateItemParameterChangeItem changeItem)

Update a task

CreateProject (CreateProjectParameterNewProject newProject)

Create a project

UpdateProject (string project_id, UpdateProjectParameterChangeProject changeProject)

Update a project

ShareProject (string project_id, ShareProjectParameterShareProject shareProject)

Share a project

CreateLabel (CreateLabelParameterNewLabel newLabel)

Create a label

UpdateLabel (string label_id, UpdateLabelParameterChangeLabel changeLabel)

Update a label

ListProjectsV2 ()

List projects (V2)

ListItemsV2 ()

List tasks (V2)

ListItemsByProjectV2 (string id)

List tasks by project (V2)

ListLabelsV2 ()

List labels (V2)

CreateItemV2 (string project_id, CreateItemV2ParameterNewItem newItem)

Create a task (V2)

UpdateItemV2 (string id, string item_id, UpdateItemV2ParameterChangeItem changeItem)

Update a task (V2)

CreateProjectV2 (CreateProjectV2ParameterNewProject newProject)

Create a project (V2)

UpdateProjectV2 (string project_id, UpdateProjectV2ParameterChangeProject changeProject)

Update a project (V2)

ShareProjectV2 (string project_id, ShareProjectV2ParameterShareProject shareProject)

Share a project (V2)

CreateLabelV2 (CreateLabelV2ParameterNewLabel newLabel)

Create a label (V2)

UpdateLabelV2 (string label_id, UpdateLabelV2ParameterChangeLabel changeLabel)

Update a label (V2)

ListProjectsV3 ()

List projects (V3)

ListItemsV3 ()

List tasks (V3)

ListItemsByProjectV3 (integer project_id)

List tasks by project (V3)

ListLabelsV3 ()

List labels (V3)

CreateItemV3 (CreateItemV3ParameterNewItem newItem)

Create a task (V3)

UpdateItemV3 (integer project_id, string id, UpdateItemV3ParameterChangeItem changeItem)

Update a task (V3)

CreateProjectV3 (CreateProjectV3ParameterNewProject newProject)

Create a project (V3)

UpdateProjectV3 (integer id, UpdateProjectV3ParameterChangeProject changeProject)

Update a project (V3)

CreateLabelV3 (CreateLabelV3ParameterNewLabel newLabel)

Create a label (V3)

UpdateLabelV3 (string id, UpdateLabelV3ParameterChangeLabel changeLabel)

Update a label (V3)

 

Triggers:

Name

Summary

OnItemCompleted (string project_id)

When a task is completed

OnItemCreated (string project_id)

When a task is created

OnItemCompletedV2 (string project_id)

When a task is completed (V2)

OnItemCreatedV2 (string project_id)

When a task is created (V2)

 

Objects:

Name

Summary

CompletedItem

 

CreateItemParameterNewItem

 

CreateItemV2ParameterNewItem

 

CreateItemV3ParameterNewItem

 

CreateLabelParameterNewLabel

 

CreateLabelV2ParameterNewLabel

 

CreateLabelV3ParameterNewLabel

 

CreateProjectParameterNewProject

 

CreateProjectV2ParameterNewProject

 

CreateProjectV3ParameterNewProject

 

Item

 

ItemV2

 

Label

 

LabelV2

 

LabelV3

 

ListItemsByProjectResponse

 

ListItemsByProjectV2Response

 

ListItemsResponse

 

ListItemsV2Response

 

ListLabelsResponse

 

ListLabelsV2Response

 

ListProjectsResponse

 

ListProjectsV2Response

 

OnItemCompletedResponse

 

OnItemCompletedV2Response

 

OnItemCreatedResponse

 

OnItemCreatedV2Response

 

Project

 

ProjectV3

 

ShareProjectParameterShareProject

 

ShareProjectV2ParameterShareProject

 

Task

 

UpdateItemParameterChangeItem

 

UpdateItemV2ParameterChangeItem

 

UpdateItemV3ParameterChangeItem

 

UpdateLabelParameterChangeLabel

 

UpdateLabelV2ParameterChangeLabel

 

UpdateLabelV3ParameterChangeLabel

 

UpdateProjectParameterChangeProject

 

UpdateProjectV2ParameterChangeProject

 

UpdateProjectV3ParameterChangeProject

 

 

Actions:

ListProjects

Summary: List projects

Description: List all projects in the Todoist account.

 

Syntax:

Todoist.ListProjects ()

 

Returns:

††††††††† Type:ListProjectsResponse

††††††††† Description: A Todoist Projects response object

 

ListItems

Summary: List tasks

Description: List all tasks in the Todoist account.

 

Syntax:

Todoist.ListItems ()

 

Returns:

††††††††† Type:ListItemsResponse

††††††††† Description: A Todoist Items response object

 

ListItemsByProject

Summary: List tasks by project

Description: List all tasks in a specific project.

 

Syntax:

Todoist.ListItemsByProject (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Project Id)

The unique identifier of the project.

True

ListProjects

 

Returns:

††††††††† Type:ListItemsByProjectResponse

††††††††† Description: A Todoist Items response object

 

ListLabels

Summary: List labels

Description: List the labels configured in the Todoist account.

 

Syntax:

Todoist.ListLabels ()

 

Returns:

††††††††† Type:ListLabelsResponse

††††††††† Description: A Todoist Labels response object

 

CreateItem

Summary: Create a task

Description: Create a new task in the specified project.

 

Syntax:

Todoist.CreateItem (string project_id, CreateItemParameterNewItem newItem)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjects

newItem

CreateItemParameterNewItem

 

A Todoist argument object for creating an Item

True

 

Returns:

††††††††† Type:Item

††††††††† Description: A Todoist Item Object

 

UpdateItem

Summary: Update a task

Description: Update an existing task.

 

Syntax:

Todoist.UpdateItem (string id, string item_id, UpdateItemParameterChangeItem changeItem)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Project Id)

The unique identifier of the project.

True

ListProjects

item_id

string

(Task Id)

The unique identifier of the task.

True

ListItemsByProject

changeItem

UpdateItemParameterChangeItem

 

A Todoist argument object for updating an item

True

 

Returns:

††††††††† Type:Item

††††††††† Description: A Todoist Item Object

 

CreateProject

Summary: Create a project

Description: Create a new project.

 

Syntax:

Todoist.CreateProject (CreateProjectParameterNewProject newProject)

 

Parameters:

Name

Type

Summary

Required

Related Action

newProject

CreateProjectParameterNewProject

 

A Todoist argument object for creating a Project

True

 

Returns:

††††††††† Type:Project

††††††††† Description: A Todoist Project Object

 

UpdateProject

Summary: Update a project

Description: Update an existing project.

 

Syntax:

Todoist.UpdateProject (string project_id, UpdateProjectParameterChangeProject changeProject)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjects

changeProject

UpdateProjectParameterChangeProject

 

A Todoist argument object for updating a Project

True

 

Returns:

††††††††† Type:Project

††††††††† Description: A Todoist Project Object

 

ShareProject

Summary: Share a project

Description: Share an existing project to a specific user.

 

Syntax:

Todoist.ShareProject (string project_id, ShareProjectParameterShareProject shareProject)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjects

shareProject

ShareProjectParameterShareProject

 

A Todoist argument object for sharing a Project

True

 

Returns:

††††††††† Type:Project

††††††††† Description: A Todoist Project Object

 

CreateLabel

Summary: Create a label

Description: Create a new label (premium users only).

 

Syntax:

Todoist.CreateLabel (CreateLabelParameterNewLabel newLabel)

 

Parameters:

Name

Type

Summary

Required

Related Action

newLabel

CreateLabelParameterNewLabel

 

A Todoist argument object for creating a Label

True

 

Returns:

††††††††† Type:Label

††††††††† Description: A Todoist Label Object

 

UpdateLabel

Summary: Update a label

Description: Update an existing label.

 

Syntax:

Todoist.UpdateLabel (string label_id, UpdateLabelParameterChangeLabel changeLabel)

 

Parameters:

Name

Type

Summary

Required

Related Action

label_id

string

(Label Id)

The unique identifier of the label.

True

ListLabels

changeLabel

UpdateLabelParameterChangeLabel

 

A Todoist argument object for updating a Label

True

 

Returns:

††††††††† Type:Label

††††††††† Description: A Todoist Label Object

 

ListProjectsV2

Summary: List projects (V2)

Description: List all projects in the Todoist account.

 

Syntax:

Todoist.ListProjectsV2 ()

 

Returns:

††††††††† Type:ListProjectsV2Response

††††††††† Description: A Todoist Projects response object

 

ListItemsV2

Summary: List tasks (V2)

Description: List all tasks in the Todoist account.

 

Syntax:

Todoist.ListItemsV2 ()

 

Returns:

††††††††† Type:ListItemsV2Response

††††††††† Description: A Todoist Items response object

 

ListItemsByProjectV2

Summary: List tasks by project (V2)

Description: List all tasks in a specific project.

 

Syntax:

Todoist.ListItemsByProjectV2 (string id)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Project Id)

The unique identifier of the project.

True

ListProjectsV2

 

Returns:

††††††††† Type:ListItemsByProjectV2Response

††††††††† Description: A Todoist Items response object

 

ListLabelsV2

Summary: List labels (V2)

Description: List the labels configured in the Todoist account.

 

Syntax:

Todoist.ListLabelsV2 ()

 

Returns:

††††††††† Type:ListLabelsV2Response

††††††††† Description: A Todoist Labels response object

 

CreateItemV2

Summary: Create a task (V2)

Description: Create a new task in the specified project.

 

Syntax:

Todoist.CreateItemV2 (string project_id, CreateItemV2ParameterNewItem newItem)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjectsV2

newItem

CreateItemV2ParameterNewItem

 

A Todoist argument object for creating an Item

True

 

Returns:

††††††††† Type:ItemV2

††††††††† Description: A Todoist Item Object

 

UpdateItemV2

Summary: Update a task (V2)

Description: Update an existing task.

 

Syntax:

Todoist.UpdateItemV2 (string id, string item_id, UpdateItemV2ParameterChangeItem changeItem)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Project Id)

The unique identifier of the project.

True

ListProjectsV2

item_id

string

(Task Id)

The unique identifier of the task.

True

ListItemsByProjectV2

changeItem

UpdateItemV2ParameterChangeItem

 

A Todoist argument object for updating an item

True

 

Returns:

††††††††† Type:ItemV2

††††††††† Description: A Todoist Item Object

 

CreateProjectV2

Summary: Create a project (V2)

Description: Create a new project.

 

Syntax:

Todoist.CreateProjectV2 (CreateProjectV2ParameterNewProject newProject)

 

Parameters:

Name

Type

Summary

Required

Related Action

newProject

CreateProjectV2ParameterNewProject

 

A Todoist argument object for creating a Project

True

 

Returns:

††††††††† Type:Project

††††††††† Description: A Todoist Project Object

 

UpdateProjectV2

Summary: Update a project (V2)

Description: Update an existing project.

 

Syntax:

Todoist.UpdateProjectV2 (string project_id, UpdateProjectV2ParameterChangeProject changeProject)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjectsV2

changeProject

UpdateProjectV2ParameterChangeProject

 

A Todoist argument object for updating a Project

True

 

Returns:

††††††††† Type:Project

††††††††† Description: A Todoist Project Object

 

ShareProjectV2

Summary: Share a project (V2)

Description: Share an existing project to a specific user.

 

Syntax:

Todoist.ShareProjectV2 (string project_id, ShareProjectV2ParameterShareProject shareProject)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjectsV2

shareProject

ShareProjectV2ParameterShareProject

 

A Todoist argument object for sharing a Project

True

 

Returns:

††††††††† Type:Project

††††††††† Description: A Todoist Project Object

 

CreateLabelV2

Summary: Create a label (V2)

Description: Create a new label.

 

Syntax:

Todoist.CreateLabelV2 (CreateLabelV2ParameterNewLabel newLabel)

 

Parameters:

Name

Type

Summary

Required

Related Action

newLabel

CreateLabelV2ParameterNewLabel

 

A Todoist argument object for creating a Label

True

 

Returns:

††††††††† Type:LabelV2

††††††††† Description: A Todoist Label Object

 

UpdateLabelV2

Summary: Update a label (V2)

Description: Update an existing label.

 

Syntax:

Todoist.UpdateLabelV2 (string label_id, UpdateLabelV2ParameterChangeLabel changeLabel)

 

Parameters:

Name

Type

Summary

Required

Related Action

label_id

string

(Label Id)

The unique identifier of the label.

True

ListLabelsV2

changeLabel

UpdateLabelV2ParameterChangeLabel

 

A Todoist argument object for updating a Label

True

 

Returns:

††††††††† Type:LabelV2

††††††††† Description: A Todoist Label Object

 

ListProjectsV3

Summary: List projects (V3)

Description: List all projects in the Todoist account.

 

Syntax:

Todoist.ListProjectsV3 ()

 

Returns:

††††††††† Type:array of (ProjectV3)

 

ListItemsV3

Summary: List tasks (V3)

Description: List all tasks in the Todoist account.

 

Syntax:

Todoist.ListItemsV3 ()

 

Returns:

††††††††† Type:array of (Task)

 

ListItemsByProjectV3

Summary: List tasks by project (V3)

Description: List all tasks in a specific project.

 

Syntax:

Todoist.ListItemsByProjectV3 (integer project_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

integer

(Project Id)

The unique identifier of the project.

True

ListProjectsV3

 

Returns:

††††††††† Type:array of (Task)

 

ListLabelsV3

Summary: List labels (V3)

Description: List the labels configured in the Todoist account.

 

Syntax:

Todoist.ListLabelsV3 ()

 

Returns:

††††††††† Type:array of (LabelV3)

 

CreateItemV3

Summary: Create a task (V3)

Description: Create a new task in the specified project.

 

Syntax:

Todoist.CreateItemV3 (CreateItemV3ParameterNewItem newItem)

 

Parameters:

Name

Type

Summary

Required

Related Action

newItem

CreateItemV3ParameterNewItem

 

A Todoist argument object for creating an Item

True

 

Returns:

††††††††† Type:Task

††††††††† Description: A Todoist Task Object

 

UpdateItemV3

Summary: Update a task (V3)

Description: Update an existing task.

 

Syntax:

Todoist.UpdateItemV3 (integer project_id, string id, UpdateItemV3ParameterChangeItem changeItem)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

integer

(Project Id)

The unique identifier of the project.

True

ListProjectsV3

id

string

(Task Id)

The unique identifier of the task.

True

ListItemsByProjectV3

changeItem

UpdateItemV3ParameterChangeItem

 

A Todoist argument object for updating an item

True

 

Returns:

 

CreateProjectV3

Summary: Create a project (V3)

Description: Create a new project.

 

Syntax:

Todoist.CreateProjectV3 (CreateProjectV3ParameterNewProject newProject)

 

Parameters:

Name

Type

Summary

Required

Related Action

newProject

CreateProjectV3ParameterNewProject

 

A Todoist argument object for creating a Project

True

 

Returns:

††††††††† Type:ProjectV3

††††††††† Description: A Todoist Project Object

 

UpdateProjectV3

Summary: Update a project (V3)

Description: Update an existing project.

 

Syntax:

Todoist.UpdateProjectV3 (integer id, UpdateProjectV3ParameterChangeProject changeProject)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

integer

(Project Id)

The unique identifier of the project.

True

ListProjectsV3

changeProject

UpdateProjectV3ParameterChangeProject

 

A Todoist argument object for updating a Project

True

 

Returns:

 

CreateLabelV3

Summary: Create a label (V3)

Description: Create a new label.

 

Syntax:

Todoist.CreateLabelV3 (CreateLabelV3ParameterNewLabel newLabel)

 

Parameters:

Name

Type

Summary

Required

Related Action

newLabel

CreateLabelV3ParameterNewLabel

 

A Todoist argument object for creating a Label

True

 

Returns:

††††††††† Type:LabelV3

††††††††† Description: A Todoist Label Object

 

UpdateLabelV3

Summary: Update a label (V3)

Description: Update an existing label.

 

Syntax:

Todoist.UpdateLabelV3 (string id, UpdateLabelV3ParameterChangeLabel changeLabel)

 

Parameters:

Name

Type

Summary

Required

Related Action

id

string

(Label Id)

The unique identifier of the label.

True

ListLabelsV3

changeLabel

UpdateLabelV3ParameterChangeLabel

 

A Todoist argument object for updating a Label

True

 

Returns:

 

Triggers:

Trigger OnItemCompleted

Summary: When a task is completed

Description: Triggers a new flow when a task is completed.

 

Syntax:

Todoist.OnItemCompleted (string project_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjects

 

Returns:

††††††††† Type:OnItemCompletedResponse

††††††††† Description: A Todoist Items response object

 

Trigger OnItemCreated

Summary: When a task is created

Description: Trigers a new flow when a task is created.

 

Syntax:

Todoist.OnItemCreated (string project_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjects

 

Returns:

††††††††† Type:OnItemCreatedResponse

††††††††† Description: A Todoist Items response object

 

Trigger OnItemCompletedV2

Summary: When a task is completed (V2)

Description: Triggers a new flow when a task is completed (premium users only).

 

Syntax:

Todoist.OnItemCompletedV2 (string project_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjectsV2

 

Returns:

††††††††† Type:OnItemCompletedV2Response

††††††††† Description: A Todoist Completed Items response object

 

Trigger OnItemCreatedV2

Summary: When a task is created (V2)

Description: Trigers a new flow when a task is created.

 

Syntax:

Todoist.OnItemCreatedV2 (string project_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

project_id

string

(Project Id)

The unique identifier of the project.

True

ListProjectsV2

 

Returns:

††††††††† Type:OnItemCreatedV2Response

††††††††† Description: A Todoist Items response object

 


 

CompletedItem

Summary:

Description: A Todoist completed task Object

 

††††††††† Properties:

Name

Type

Summary

id

string

Task Entry Id

The id of the completed task entry.

task_id

integer(int32)

Task Id

The id of the completed task.

user_id

integer(int32)

Task Owner

The owner of the task.

project_id

string

Project Id

The project where task resides.

content

string

Task Title

The title of the task.

completed_date

string(date-time)

Date Completed

The date when the task was completed.

note_count

integer(int32)

Notes Count

The number of notes of the task.

meta_data

string

Details

Optional extra details.


 

CreateItemParameterNewItem

Summary:

Description: A Todoist argument object for creating an Item

 

††††††††† Properties:

Name

Type

Summary

content

string

Title

The title of the task.

date_string

string(date-time)

Due Date

The task due date (e.g mm-dd-yyyy, Today @ 11am, mm/dd/yyyy).

priority

string

Priority

A number between 1 and 4 (4 for very urgent and 1 for natural).

indent

string

Indent

A number between 1 and 4, where 1 is top-level).

item_order

string

Order

A number, where the smallest value is top-level.


 

CreateItemV2ParameterNewItem

Summary:

Description: A Todoist argument object for creating an Item

 

††††††††† Properties:

Name

Type

Summary

content

string

Title

The title of the task.

date_string

string(date-time)

Due Date

The task due date (e.g 2017-07-21T17:32:28Z).

priority

string

Priority

A number between 1 and 4 (4 for very urgent and 1 for natural).

parent_id

string

Parent Id

The id of the parent task. Set to null for root tasks

child_order

integer

Child order

The order of task. Defines the position of the task among all the tasks with the same Parent Id


 

CreateItemV3ParameterNewItem

Summary:

Description: A Todoist argument object for creating an Item

 

††††††††† Properties:

Name

Type

Summary

content

string

Title

The title of the task.

project_id

integer

Project Id

Task project id. If not set, task is put to userís Inbox.

due_string

string(date-time)

Due Date

The task due date (e.g 2017-07-21T17:32:28Z).

priority

string

Priority

A number between 1 and 4 (4 for very urgent and 1 for natural).

parent_id

integer

Parent Id

The id of the parent task. Set to null for root tasks

order

integer

Child order

The order of task. Defines the position of the task among all the tasks with the same Parent Id


 

CreateLabelParameterNewLabel

Summary:

Description: A Todoist argument object for creating a Label

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the label.

color

string

Color

The color of the label (a number between 0 and 7, or 0 and 12 for premium users).

item_order

string

Order

The label's order in the label list (a number, where the smallest value is top-level).


 

CreateLabelV2ParameterNewLabel

Summary:

Description: A Todoist argument object for creating a Label

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the label.

color

string

Color

Color id. Itís a value between 30 and 49.

item_order

string

Order

Labelís order in the label list (a number, where the smallest value should place the label at the top).


 

CreateLabelV3ParameterNewLabel

Summary:

Description: A Todoist argument object for creating a Label

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the label.

color

integer

Color

Color id. Itís a value between 30 and 49.

order

integer

Order

Labelís order in the label list (a number, where the smallest value should place the label at the top).


 

CreateProjectParameterNewProject

Summary:

Description: A Todoist argument object for creating a Project

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the project.

color

string

Color

A number between 0 and 11, or 0 and 21 for premium users.

indent

string

Indent

A number between 1 and 4, where 1 is top-level).

item_order

string

Order

A number, where the smallest value is top-level.


 

CreateProjectV2ParameterNewProject

Summary:

Description: A Todoist argument object for creating a Project

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the project.

color

integer

Color

Color id. Itís a value between 30 and 49.

parent_id

string

Parent Id

The id of the parent project. Set to null for root projects

child_order

integer

Child order

The order of project. Defines the position of the project among all the projects with the same Parent Id

is_favorite

integer

Is favorite

Whether the project is favorite (where 1 is true and 0 is false).


 

CreateProjectV3ParameterNewProject

Summary:

Description: A Todoist argument object for creating a Project

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the project.

color

integer

Color

Color id. Itís a value between 30 and 49.

parent_id

integer

Parent Id

The id of the parent project. Set to null for root projects

favorite

boolean

Is favorite

Whether the project is favorite (a true or false value).


 

Item

Summary:

Description: A Todoist Item Object

 

††††††††† Properties:

Name

Type

Summary

content

string

Task Title

The title of the task.

id

string

Task Id

The id of the task.

user_id

integer(int32)

Task Owner

The owner of the task.

project_id

string

Project Id

The project where task resides.

date_lang

string

Date Language

The language of the date (valid languages are: en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl).

due_date_utc

string(date-time)

Task Due Date

The date of the task in the format Mon 07 Aug 2006 12:34:56 +0000.

indent

integer(int32)

Indent

The indent of the task (a number between 1 and 4, where 1 is top-level).

priority

integer(int32)

Task Priority

The priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural).

item_order

integer(int32)

Order

The order of the task inside a project (the smallest value would place the task at the top).

day_order

integer(int32)

DayOrder

The order of the task inside the Today or Next 7 days view (a number, where the smallest value would place the task at the top).

collapsed

integer(int32)

Collapsed

Whether the taskís sub-tasks are collapsed (where 1 is true and 0 is false).

children

string

Children

Children

assigned_by_uid

integer(int32)

Assigner Id

The id of the user who assigns the current task. For shared projects only.

responsible_uid

integer(int32)

Assignee Id

The id of user who is responsible for accomplishing the current task. For shared projects only.

checked

integer(int32)

IsTaskCompleted

Whether the task is marked as completed (where 1 is true and 0 is false).

in_history

integer(int32)

IsTaskInHistory

Whether the task has been marked as completed and is marked to be moved to history.

is_deleted

integer(int32)

IsDeleted

Whether the task is marked as deleted (where 1 is true and 0 is false).

is_archived

integer(int32)

IsTaskArchived

Whether the task is marked as archived (where 1 is true and 0 is false).

sync_id

integer(int32)

SyncId

A special id for shared tasks (a number or null if not set). Used internally and can be ignored.

date_added

string(date-time)

Date Created

The date when the task was created.


 

ItemV2

Summary:

Description: A Todoist Item Object

 

††††††††† Properties:

Name

Type

Summary

content

string

Task Title

The title of the task.

id

string

Task Id

The id of the task.

user_id

integer(int32)

Task Owner

The owner of the task.

project_id

string

Project Id

The project where task resides.

date_lang

string

Date Language

The language of the date (valid languages are: en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl).

due_date_utc

string(date-time)

Task Due Date

The date of the task in the format 2006-08-07T16:34:56Z.

parent_id

integer(int32)

Parent Id

The id of the parent task. Set to null for root tasks

child_order

integer(int32)

Child order

The order of task. Defines the position of the task among all the tasks with the same parent_id

priority

integer(int32)

Task Priority

The priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural).

day_order

integer(int32)

DayOrder

The order of the task inside the Today or Next 7 days view (a number, where the smallest value would place the task at the top).

collapsed

integer(int32)

Collapsed

Whether the taskís sub-tasks are collapsed (where 1 is true and 0 is false).

assigned_by_uid

integer(int32)

Assigner Id

The id of the user who assigns the current task. For shared projects only.

responsible_uid

integer(int32)

Assignee Id

The id of user who is responsible for accomplishing the current task. For shared projects only.

checked

integer(int32)

IsTaskCompleted

Whether the task is marked as completed (where 1 is true and 0 is false).

in_history

integer(int32)

IsTaskInHistory

Whether the task has been marked as completed and is marked to be moved to history.

is_deleted

integer(int32)

IsDeleted

Whether the task is marked as deleted (where 1 is true and 0 is false).

sync_id

integer(int32)

SyncId

A special id for shared tasks (a number or null if not set). Used internally and can be ignored.

date_added

string(date-time)

Date Created

The date when the task was created.


 

Label

Summary:

Description: A Todoist Label Object

 

††††††††† Properties:

Name

Type

Summary

id

integer(int32)

Label Id

The id of the label.

name

string

Label Name

The name of the label.

color

integer(int32)

Color

The color of the label (a number between 0 and 7, or between 0 and 12 for premium users).

item_order

integer(int32)

Order

Labelís order in the label list (a number, where the smallest value is top-level).

is_deleted

integer(int32)

IsDeleted

Whether the label is marked as deleted (where 1 is true and 0 is false).


 

LabelV2

Summary:

Description: A Todoist Label Object

 

††††††††† Properties:

Name

Type

Summary

id

integer(int32)

Label Id

The id of the label.

name

string

Label Name

The name of the label.

color

integer(int32)

Color

Color id. Itís a value between 30 and 49, more info - https://developer.todoist.com/sync/v8/#colors

item_order

integer(int32)

Order

Labelís order in the label list (a number, where the smallest value should place the label at the top).

is_deleted

integer(int32)

IsDeleted

Whether the label is marked as deleted (where 1 is true and 0 is false).

is_favorite

integer(int32)

IsFavorite

Whether the label is favorite (where 1 is true and 0 is false).


 

LabelV3

Summary:

Description: A Todoist Label Object

 

††††††††† Properties:

Name

Type

Summary

id

integer(int32)

Label Id

The id of the label.

name

string

Label Name

The name of the label.

color

integer(int32)

Color

Color id. Itís a value between 30 and 49, more info - https://developer.todoist.com/sync/v8/#colors

order

integer(int32)

Order

Labelís order in the label list (a number, where the smallest value should place the label at the top).

favorite

boolean

IsFavorite

Whether the label is favorite (a true or false value).


 

ListItemsByProjectResponse

Summary:

Description: A Todoist Items response object

 

††††††††† Properties:

Name

Type

Summary

items

array of (Item)

Items

A collection of items


 

ListItemsByProjectV2Response

Summary:

Description: A Todoist Items response object

 

††††††††† Properties:

Name

Type

Summary

items

array of (ItemV2)

Items

A collection of items


 

ListItemsResponse

Summary:

Description: A Todoist Items response object

 

††††††††† Properties:

Name

Type

Summary

items

array of (Item)

Items

A collection of items


 

ListItemsV2Response

Summary:

Description: A Todoist Items response object

 

††††††††† Properties:

Name

Type

Summary

items

array of (ItemV2)

Items

A collection of items


 

ListLabelsResponse

Summary:

Description: A Todoist Labels response object

 

††††††††† Properties:

Name

Type

Summary

labels

array of (Label)

Labels

A collection of labels


 

ListLabelsV2Response

Summary:

Description: A Todoist Labels response object

 

††††††††† Properties:

Name

Type

Summary

labels

array of (LabelV2)

Labels

A collection of labels


 

ListProjectsResponse

Summary:

Description: A Todoist Projects response object

 

††††††††† Properties:

Name

Type

Summary

projects

array of (Project)

Projects

A collection of projects


 

ListProjectsV2Response

Summary:

Description: A Todoist Projects response object

 

††††††††† Properties:

Name

Type

Summary

projects

array of (Project)

Projects

A collection of projects


 

OnItemCompletedResponse

Summary:

Description: A Todoist Items response object

 

††††††††† Properties:

Name

Type

Summary

items

array of (Item)

Items

A collection of items


 

OnItemCompletedV2Response

Summary:

Description: A Todoist Completed Items response object

 

††††††††† Properties:

Name

Type

Summary

items

array of (CompletedItem)

Completed Items

A collection of completed items


 

OnItemCreatedResponse

Summary:

Description: A Todoist Items response object

 

††††††††† Properties:

Name

Type

Summary

items

array of (Item)

Items

A collection of items


 

OnItemCreatedV2Response

Summary:

Description: A Todoist Items response object

 

††††††††† Properties:

Name

Type

Summary

items

array of (ItemV2)

Items

A collection of items


 

Project

Summary:

Description: A Todoist Project Object

 

††††††††† Properties:

Name

Type

Summary

id

string

Project Id

The unique identifier of the project.

name

string

Project Name

The name of the project.

color

integer(int32)

Color

The color of the project.

shared

boolean

Is Project Shared

Is Project Shared

is_deleted

integer(int32)

Is Project Deleted

A number value (1 is true, 0 is false) indicating whether or not the project is deleted.

is_archived

integer(int32)

Is Project Archived

A number value (1 is true, 0 is false) indicating whether or not the project is archived.


 

ProjectV3

Summary:

Description: A Todoist Project Object

 

††††††††† Properties:

Name

Type

Summary

id

integer(int32)

Project Id

The unique identifier of the project.

name

string

Project Name

The name of the project.

comment_count

integer(int32)

Comment Count

The number of comments.

order

integer(int32)

Order

The order of the project under the same parent.

color

integer(int32)

Color

The color of the project.

shared

boolean

Is Project Shared

Is Project Shared

sync_id

integer(int32)

Sync Id

Identifier to find the match between different copies of shared projects.

favorite

boolean

Is Project Favorite

Is Project Favorite

inbox_project

boolean

Is Project Shared

Is Project Inbox


 

ShareProjectParameterShareProject

Summary:

Description: A Todoist argument object for sharing a Project

 

††††††††† Properties:

Name

Type

Summary

email

string

Email

The email address of user the project is being shared to.


 

ShareProjectV2ParameterShareProject

Summary:

Description: A Todoist argument object for sharing a Project

 

††††††††† Properties:

Name

Type

Summary

email

string

Email

The user email with whom to share the project.


 

Task

Summary:

Description: A Todoist Task Object

 

††††††††† Properties:

Name

Type

Summary

id

integer(int32)

Task Id

The id of the task.

completed

boolean

Is Task Completed

Is task completed

project_id

integer(int32)

Project Id

The project where task resides.

section_id

integer(int32)

Section Id

Id of section task belongs to.

parent_id

integer(int32)

Parent Id

The id of the parent task. Set to null for root tasks.

content

string

Task content

Task content.

comment_count

integer(int32)

Comment count

Number of task comments

order

integer(int32)

Order

The order of task. Defines the position of the task among all the tasks with the same parent_id

priority

integer(int32)

Task Priority

The priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural).

url

string

Task URL

URL to access this task in Todoist web interface.


 

UpdateItemParameterChangeItem

Summary:

Description: A Todoist argument object for updating an item

 

††††††††† Properties:

Name

Type

Summary

content

string

Title

The title of the task.

priority

string

Priority

A number between 1 and 4, 4 for very urgent and 1 for natural.

indent

string

Indent

A number between 1 and 4, where 1 is top-level).

item_order

string

Order

A number, where the smallest value is top-level.


 

UpdateItemV2ParameterChangeItem

Summary:

Description: A Todoist argument object for updating an item

 

††††††††† Properties:

Name

Type

Summary

content

string

Title

The title of the task.

priority

string

Priority

A number between 1 and 4, 4 for very urgent and 1 for natural.


 

UpdateItemV3ParameterChangeItem

Summary:

Description: A Todoist argument object for updating an item

 

††††††††† Properties:

Name

Type

Summary

content

string

Title

The title of the task.

priority

string

Priority

A number between 1 and 4, 4 for very urgent and 1 for natural.


 

UpdateLabelParameterChangeLabel

Summary:

Description: A Todoist argument object for updating a Label

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the label.

color

string

Color

The color of the label (a number between 0 and 7, or 0 and 12 for premium users).

item_order

string

Order

The label's order in the label list (a number, where the smallest value is top-level).


 

UpdateLabelV2ParameterChangeLabel

Summary:

Description: A Todoist argument object for updating a Label

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the label.

color

string

Color

Color id. Itís a value between 30 and 49.

item_order

string

Order

Labelís order in the label list.


 

UpdateLabelV3ParameterChangeLabel

Summary:

Description: A Todoist argument object for updating a Label

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the label.

color

integer

Color

Color id. Itís a value between 30 and 49.

order

integer

Order

Labelís order in the label list.


 

UpdateProjectParameterChangeProject

Summary:

Description: A Todoist argument object for updating a Project

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the project.

color

string

Color

A number between 0 and 11, or 0 and 21 for premium users.

indent

string

Indent

A number between 1 and 4, where 1 is top-level).

item_order

string

Order

A number, where the smallest value is top-level.


 

UpdateProjectV2ParameterChangeProject

Summary:

Description: A Todoist argument object for updating a Project

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the project.

color

string

Color

Color id. Itís a value between 30 and 49.

is_favorite

integer

Is favorite

Whether the project is favorite (where 1 is true and 0 is false).


 

UpdateProjectV3ParameterChangeProject

Summary:

Description: A Todoist argument object for updating a Project

 

††††††††† Properties:

Name

Type

Summary

name

string

Name

The name of the project.

color

string

Color

Color id. Itís a value between 30 and 49.

favorite

boolean

Is favorite

Whether the project is favorite (a true or false value).