Todoist

Todoist is a task management application that helps users organize and prioritize their to-do lists.

Categories: productivity-and-collaboration

Type: todoist/v1

---

Connections

Version: 1

OAuth2 Authorization Code

Properties

Name	Label	Type	Description	Required
clientId	Client Id	STRING		true
clientSecret	Client Secret	STRING		true

---

Actions

Create Task

Name: createTask

Creates a new task.

Properties

Name	Label	Type	Description	Required
content	Content	STRING	Task content. It may contain some markdown-formatted text and hyperlinks.	true
description	Description	STRING	A description for the task. This value may contain some markdown-formatted text and hyperlinks.	false
project_id	Project ID	STRING	Task project ID. If not set, task is put to user’s Inbox.	false
priority	Priority	INTEGER Options 1, 2, 3, 4	Task priority from 1 (normal) to 4 (urgent).	false

Example JSON Structure

{
  "label" : "Create Task",
  "name" : "createTask",
  "parameters" : {
    "content" : "",
    "description" : "",
    "project_id" : "",
    "priority" : 1
  },
  "type" : "todoist/v1/createTask"
}

Output

Type: OBJECT

Properties

Name	Type	Description
id	STRING	ID of the task.
project_id	STRING	ID of the project.
content	STRING	Task content.
description	STRING	Task description.
priority	INTEGER	Task priority.

Output Example

{
  "id" : "",
  "project_id" : "",
  "content" : "",
  "description" : "",
  "priority" : 1
}

Mark Task as Completed

Name: markTaskCompleted

Mark a tas as being completed.

Properties

Name	Label	Type	Description	Required
taskId	Task ID	STRING	ID of the task to be closed.	true

Example JSON Structure

{
  "label" : "Mark Task as Completed",
  "name" : "markTaskCompleted",
  "parameters" : {
    "taskId" : ""
  },
  "type" : "todoist/v1/markTaskCompleted"
}

Output

This action does not produce any output.

Create Project

Name: createProject

Creates a new project.

Properties

Name	Label	Type	Description	Required
name	Name	STRING	Name of the project.	true
color	Color	STRING Options beryy_red, red, orange, yellow, olive_green, lime_green, green, mint_green, teal, sky_blue, light_blue, blue, grape, violet, lavender, magenta, salmon, charcoal, grey, taupe		false
is_favorite	Is Project a Favorite?	BOOLEAN Options true, false	Whether the project is a favorite.	false

Example JSON Structure

{
  "label" : "Create Project",
  "name" : "createProject",
  "parameters" : {
    "name" : "",
    "color" : "",
    "is_favorite" : false
  },
  "type" : "todoist/v1/createProject"
}

Output

Type: OBJECT

Properties

Name	Type	Description
id	STRING	ID of the project.
name	STRING	Name of the project.
color	STRING	Color of the project icon.
is_favorite	STRING	Whether the project is a favorite.
url	STRING	URL of the project.

Output Example

{
  "id" : "",
  "name" : "",
  "color" : "",
  "is_favorite" : "",
  "url" : ""
}