Todoist

1. Overview

Todoist is a leading task management and productivity application that helps users organize their work and life. It allows for the creation of tasks, sub-tasks, projects, and setting deadlines, all accessible across multiple platforms.

With the GoInsight Todoist node, you can seamlessly integrate task management into your automated workflows. This allows you to programmatically manage the entire lifecycle of your tasks, including:

• Task Management: Create, retrieve, update, and delete tasks.
• Task State Control: Close (complete), reopen, and move tasks between projects or sections.
• Project Information: Fetch a complete list of your projects to use their IDs in other operations.

2. Prerequisites

Before using this node, you must have a valid Todoist account. You will need to generate an API token from your Todoist settings to authenticate your requests.

3. Credentials

For a detailed guide on how to obtain and configure your credentials, please refer to our official documentation: Credentials Configuration Guide.

4. Supported Operations

Summary

This node provides operations centered around managing Projects and Tasks within your Todoist account.

Operation Details

Create a Task

Creates a new task in Todoist with the specified parameters.

Input Parameters:

• Content: Task content. Required.

Options:

• Description: Task description.
• ProjectId: Project ID to add the task to.
• SectionId: Section ID to add the task to.
• ParentId: Parent task ID.
• Order: Order among siblings.
• Labels: List of label names.
• Priority: Task priority (1-4).
• DueString: Human-defined due date.
• DueDate: Due date in YYYY-MM-DD format.
• DueDatetime: Due date-time in RFC3339 UTC.
• DueLang: Language code for due_string.
• AssigneeId: ID of the assignee user.
• Duration: Duration amount.
• DurationUnit: Unit of duration ('minute' or 'day').
• DeadlineDate: Deadline date in YYYY-MM-DD format.

Output:

• Task (object): The created task object returned by Todoist API.
• StatusCode (number): HTTP status code indicating result (200 for success).
• ErrorMessage (string): Error message if any, empty when no error.

Delete a Task

Deletes a task in Todoist specified by its task ID. This action permanently removes the task.

Input Parameters:

• TaskId: The ID of the task to be deleted.

Output:

• Deleted (bool): Indicates whether the task was successfully deleted.
• StatusCode (number): HTTP status code returned by the API. 204 indicates success, -1 parameter error, 500 exception.
• ErrorMessage (string): Error message if any, empty when no error.

Get Many Projects

Fetches all projects from Todoist using the REST API.

Output:

• Projects (object-array): A list of project objects returned by the API.
• StatusCode (number): Status code of the operation: -1 for parameter error, HTTP status code for API errors, 500 for exceptions.
• ErrorMessage (string): Error message if any, empty if successful.

Get Many Tasks

Retrieves multiple Todoist tasks matching optional filters: project_id, section_id, label_id, filter query, and language.

Options:

• ProjectId: Filter tasks by project ID, optional, empty string indicates no filtering.
• SectionId: Filter tasks by section ID, optional, empty string indicates no filtering.
• LabelId: Filter tasks by tag ID, optional, empty string indicates no filtering.
• Filter: Todoist filter expression, optional, empty string indicates no filtering.
• Lang: Language code for filtering expressions and task content, optional.

Output:

• Tasks (object-array): A list of tasks that meet the query criteria, with each item being a Todoist task object.
• StatusCode (number): The operation result status code is 200 indicating success, -1 parameter error, 500 abnormal error, and other values are HTTP status codes returned by the API.
• ErrorMessage (string): Error description, an empty string indicates no error.

Get a Task

Retrieves a Todoist task specified by its task ID.

Input Parameters:

• TaskId: The ID of the task to retrieve.

Output:

• Task (object): The task object returned by Todoist API.
• StatusCode (number): HTTP status code returned by the API. 200 indicates success, -1 parameter error, 500 exception.
• ErrorMessage (string): Error message if any, empty when no error.

Close a Task

Closes a Todoist task specified by its task ID. This action marks the task as completed.

Input Parameters:

• TaskId: The ID of the task to close.

Output:

• Closed (bool): Indicates whether the task was successfully closed.
• StatusCode (number): HTTP status code returned by the API. 204 indicates success, -1 parameter error, 500 exception.
• ErrorMessage (string): Error message if any, empty when no error.

Move a Task

Moves a Todoist task to a specified project, section, parent task, or reorders it.

Input Parameters:

• TaskId: The ID of the task to move. (required)
• ProjectId: The target project ID.

Options:

• SectionId: The target section ID within the project. (optional)
• ParentId: The new parent task ID for nesting. (optional)

Output:

• Moved (bool): Is the task successfully transferred
• StatusCode (number): HTTP status code indicating result: 200 for success, -1 for parameter error, 500 for exception, other codes as returned by API.
• ErrorMessage (string): Error message if any, empty when no error.

Reopen a Task

Reopens a Todoist task specified by its task ID. Any ancestor items or sections will also be marked as uncompleted and restored from history.

Input Parameters:

• TaskId: The ID of the task to reopen.

Output:

• Reopened (bool): Indicates whether the task was successfully reopened.
• StatusCode (number): Operation result code: 204 for success, -1 for parameter error, 500 for exception, others as returned by the API.
• ErrorMessage (string): Error message if any, empty when no error.

Update a Task

Updates a Todoist task specified by its task ID. You can update content, description, labels, priority, due date/time, assignee, duration, and deadline.

Input Parameters:

• TaskId: The ID of the task to update.
• Content: New task content.

Options:

• Description: New task description.
• Labels: New labels list.
• Priority: Task priority (1–4).
• DueString: Human-friendly due date string.
• DueDate: Specific due date (YYYY-MM-DD).
• DueDatetime: Specific due datetime (RFC3339 UTC).
• DueLang: Language code for due_string if not English.
• AssigneeId: ID of the user to assign the task to.
• Duration: Duration amount.
• DurationUnit: Duration unit, "minute" or "day".
• DeadlineDate: Deadline date (YYYY-MM-DD).

Output:

• Task (object): The updated task object returned by the Todoist API.
• StatusCode (number): Operation result code: 200 for success, -1 for parameter error, 500 for exception, other values as returned by API.
• ErrorMessage (string): Error message if any, empty when no error.

5. Example Usage

This section will guide you through creating a simple workflow to add a new task to your Todoist inbox.

The workflow will consist of: Start -> Create a Task -> Answer.

1. Add the Tool Node

• In the workflow canvas, click the + button to add a new node.
• Select the "Tools" tab in the pop-up panel.
• Find and select "Todoist" from the list of tools.
• From the list of supported operations for Todoist, click on "Create a Task" to add the node to your canvas.

2. Configure the Node

• Click on the newly added "Create a Task" node to open its configuration panel on the right.
• Credentials: In the credentials field at the top, click the dropdown menu and select your pre-configured Todoist credential.
• Parameters: Fill in the required input parameters for the action.
  • Content: This is the title of your task. Enter a descriptive name, for example, Follow up with the design team.
  • Description (Optional): You can add more details about the task here, such as Discuss the new mockups for the landing page.
  • DueString (Optional): To set a deadline, you can use human-readable text like tomorrow at 4pm or every Friday.

3. Run and Validate

• Once all required parameters are correctly filled, any error indicators on the workflow canvas will disappear.
• Click the "Run Test" button in the top-right corner of the canvas to execute the workflow.
• After a successful run, you can click the logs icon in the top-right corner to view the detailed inputs and outputs of the node, confirming that the task was created successfully.

After completing these steps, your workflow is fully configured. Every time you run it, a new task will be created in your Todoist account.

6. FAQs

Q: Why am I getting a 401 Unauthorized error?

A: This error typically means there is an issue with your API token. Please check the following:

• Ensure the API token entered in your GoInsight credential is correct and has not expired.
• Verify that the token has the necessary permissions to perform the requested actions (e.g., task:add, data:read_write).

Q: How can I find the ID for a specific project or section?

A: You can use the Get Many Projects operation to retrieve a list of all your projects along with their corresponding IDs. You can build a simple workflow to run this operation and view the output in the logs to find the ID you need for other operations like Create a Task.

7. Official Documentation

For more in-depth information about the Todoist API, please refer to the Todoist Official API Documentation.