Todoist Blocks

Todoist Create Label

What it is

A block that creates a new label in Todoist.

What it does

Creates a new label in Todoist with specified name, order, color and favorite status.

How it works

It takes label details as input, connects to Todoist API, creates the label and returns the created label's details.

Inputs

Input	Description
Credentials	Todoist API credentials
Name	Name of the label
Order	Optional label order
Color	Optional color of the label icon
Is Favorite	Whether label is marked as favorite

Outputs

Output	Description
ID	ID of the created label
Name	Name of the label
Color	Color of the label
Order	Label order
Is Favorite	Favorite status
Error	Error message if request failed

Possible use case

Creating new labels to organize and categorize tasks in Todoist.

Todoist List Labels

What it is

A block that retrieves all personal labels from Todoist.

What it does

Fetches all personal labels from the user's Todoist account.

How it works

Connects to Todoist API using provided credentials and retrieves all labels.

Inputs

Input	Description
Credentials	Todoist API credentials

Outputs

Output	Description
Labels	List of complete label data
Label IDs	List of label IDs
Label Names	List of label names
Error	Error message if request failed

Possible use case

Getting an overview of all labels to organize tasks or find specific labels.

Todoist Get Label

What it is

A block that retrieves a specific label by ID.

What it does

Fetches details of a specific label using its ID.

How it works

Uses the label ID to retrieve label details from Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Label ID	ID of label to retrieve

Outputs

Output	Description
ID	Label ID
Name	Label name
Color	Label color
Order	Label order
Is Favorite	Favorite status
Error	Error message if request failed

Possible use case

Looking up details of a specific label for editing or verification.

Todoist Create Task

What it is

A block that creates a new task in Todoist.

What it does

Creates a new task with specified content, description, project assignment and other optional parameters.

How it works

Takes task details and creates a new task via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Content	Task content
Description	Optional task description
Project ID	Optional project to add task to
Section ID	Optional section to add task to
Parent ID	Optional parent task ID
Order	Optional task order
Labels	Optional task labels
Priority	Optional priority (1-4)
Due Date	Optional due date
Deadline Date	Optional deadline date
Assignee ID	Optional assignee
Duration Unit	Optional duration unit
Duration	Optional duration amount

Outputs

Output	Description
ID	Created task ID
URL	Task URL
Complete Data	Complete task data
Error	Error message if request failed

Possible use case

Creating new tasks with full customization of parameters.

Todoist Get Tasks

What it is

A block that retrieves active tasks from Todoist.

What it does

Fetches tasks based on optional filters like project, section, label etc.

How it works

Queries Todoist API with provided filters to get matching tasks.

Inputs

Input	Description
Credentials	Todoist API credentials
Project ID	Optional filter by project
Section ID	Optional filter by section
Label	Optional filter by label
Filter	Optional custom filter string
Lang	Optional filter language
IDs	Optional specific task IDs

Outputs

Output	Description
IDs	List of task IDs
URLs	List of task URLs
Complete Data	Complete task data
Error	Error message if request failed

Possible use case

Retrieving tasks matching specific criteria for review or processing.

Todoist Update Task

What it is

A block that updates an existing task.

What it does

Updates specified fields of an existing task.

How it works

Takes task ID and updated fields, applies changes via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Task ID	ID of task to update
Content	New task content
Description	New description
Project ID	New project ID
Section ID	New section ID
Parent ID	New parent task ID
Order	New order
Labels	New labels
Priority	New priority
Due Date	New due date
Deadline Date	New deadline date
Assignee ID	New assignee
Duration Unit	New duration unit
Duration	New duration

Outputs

Output	Description
Success	Whether update succeeded
Error	Error message if failed

Possible use case

Modifying task details like due dates, priority etc.

Todoist Close Task

What it is

A block that completes/closes a task.

What it does

Marks a task as complete in Todoist.

How it works

Uses task ID to mark it complete via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Task ID	ID of task to close

Outputs

Output	Description
Success	Whether task was closed
Error	Error message if failed

Possible use case

Marking tasks as done in automated workflows.

Todoist Reopen Task

What it is

A block that reopens a completed task.

What it does

Marks a completed task as active again.

How it works

Uses task ID to reactivate via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Task ID	ID of task to reopen

Outputs

Output	Description
Success	Whether task was reopened
Error	Error message if failed

Possible use case

Reactivating tasks that were closed accidentally or need to be repeated.

Todoist Delete Task

What it is

A block that permanently deletes a task.

What it does

Removes a task completely from Todoist.

How it works

Uses task ID to delete via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Task ID	ID of task to delete

Outputs

Output	Description
Success	Whether deletion succeeded
Error	Error message if failed

Possible use case

Removing unwanted or obsolete tasks from the system.

Todoist List Projects

What it is

A block that retrieves all projects from Todoist.

What it does

Fetches all projects and their details from a user's Todoist account.

How it works

Connects to Todoist API using provided credentials and retrieves all projects.

Inputs

Input	Description
Credentials	Todoist API credentials

Outputs

Output	Description
Names List	List of project names
IDs List	List of project IDs
URL List	List of project URLs
Complete Data	Complete project data
Error	Error message if request failed

Possible use case

Getting an overview of all projects for organization or automation.

Todoist Create Project

What it is

A block that creates a new project in Todoist.

What it does

Creates a new project with specified name, parent project, color and other settings.

How it works

Takes project details and creates via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Name	Name of the project
Parent ID	Optional parent project ID
Color	Optional color of project icon
Is Favorite	Whether project is favorite
View Style	Display style (list/board)

Outputs

Output	Description
Success	Whether creation succeeded
Error	Error message if failed

Possible use case

Creating new projects programmatically for workflow automation.

Todoist Get Project

What it is

A block that retrieves details for a specific project.

What it does

Fetches complete details of a single project by ID.

How it works

Uses project ID to retrieve details via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Project ID	ID of project to get

Outputs

Output	Description
Project ID	ID of the project
Project Name	Name of the project
Project URL	URL of the project
Complete Data	Complete project data
Error	Error message if failed

Possible use case

Looking up project details for verification or editing.

Todoist Update Project

What it is

A block that updates an existing project.

What it does

Updates specified fields of an existing project.

How it works

Takes project ID and updated fields, applies via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Project ID	ID of project to update
Name	New project name
Color	New color for icon
Is Favorite	New favorite status
View Style	New display style

Outputs

Output	Description
Success	Whether update succeeded
Error	Error message if failed

Possible use case

Modifying project settings or reorganizing projects.

Todoist Delete Project

What it is

A block that deletes a project and its contents.

What it does

Permanently removes a project including sections and tasks.

How it works

Uses project ID to delete via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Project ID	ID of project to delete

Outputs

Output	Description
Success	Whether deletion succeeded
Error	Error message if failed

Possible use case

Removing completed or obsolete projects.

Todoist List Collaborators

What it is

A block that retrieves collaborators on a project.

What it does

Fetches all collaborators and their details for a specific project.

How it works

Uses project ID to get collaborator list via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Project ID	ID of project to check

Outputs

Output	Description
Collaborator IDs	List of collaborator IDs
Collaborator Names	List of collaborator names
Collaborator Emails	List of collaborator emails
Complete Data	Complete collaborator data
Error	Error message if failed

Possible use case

Managing project sharing and collaboration.

Todoist List Sections

What it is

A block that retrieves sections from Todoist.

What it does

Fetches all sections, optionally filtered by project.

How it works

Connects to Todoist API to retrieve sections list.

Inputs

Input	Description
Credentials	Todoist API credentials
Project ID	Optional project filter

Outputs

Output	Description
Names List	List of section names
IDs List	List of section IDs
Complete Data	Complete section data
Error	Error message if failed

Possible use case

Getting section information for task organization.

Todoist Get Section

What it is

A block that retrieves details for a specific section.

What it does

Fetches complete details of a single section by ID.

How it works

Uses section ID to retrieve details via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Section ID	ID of section to get

Outputs

Output	Description
ID	Section ID
Project ID	Parent project ID
Order	Section order
Name	Section name
Error	Error message if failed

Possible use case

Looking up section details for task management.

Todoist Delete Section

What it is

A block that deletes a section and its tasks.

What it does

Permanently removes a section including all tasks.

How it works

Uses section ID to delete via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Section ID	ID of section to delete

Outputs

Output	Description
Success	Whether deletion succeeded
Error	Error message if failed

Possible use case

Removing unused sections or reorganizing projects.

Todoist Create Comment

What it is

A block that creates a new comment on a Todoist task or project.

What it does

Creates a comment with specified content on either a task or project.

How it works

Takes comment content and task/project ID, creates comment via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Content	Comment content
ID Type	Task ID or Project ID to comment on
Attachment	Optional file attachment

Outputs

Output	Description
ID	ID of created comment
Content	Comment content
Posted At	Comment timestamp
Task ID	Associated task ID
Project ID	Associated project ID
Error	Error message if request failed

Possible use case

Adding notes and comments to tasks or projects automatically.

Todoist Get Comments

What it is

A block that retrieves all comments for a task or project.

What it does

Fetches all comments associated with a specific task or project.

How it works

Uses task/project ID to get comments list via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
ID Type	Task ID or Project ID to get comments for

Outputs

Output	Description
Comments	List of comments
Error	Error message if request failed

Possible use case

Reviewing comment history on tasks or projects.

Todoist Get Comment

What it is

A block that retrieves a specific comment by ID.

What it does

Fetches details of a single comment using its ID.

How it works

Uses comment ID to retrieve details via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Comment ID	ID of comment to retrieve

Outputs

Output	Description
Content	Comment content
ID	Comment ID
Posted At	Comment timestamp
Project ID	Associated project ID
Task ID	Associated task ID
Attachment	Optional file attachment
Error	Error message if request failed

Possible use case

Looking up specific comment details for reference.

Todoist Update Comment

What it is

A block that updates an existing comment.

What it does

Updates the content of a specific comment.

How it works

Takes comment ID and new content, updates via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Comment ID	ID of comment to update
Content	New content for the comment

Outputs

Output	Description
Success	Whether update succeeded
Error	Error message if request failed

Possible use case

Modifying existing comments to fix errors or update information.

Todoist Delete Comment

What it is

A block that deletes a comment.

What it does

Permanently removes a comment from a task or project.

How it works

Uses comment ID to delete via Todoist API.

Inputs

Input	Description
Credentials	Todoist API credentials
Comment ID	ID of comment to delete

Outputs

Output	Description
Success	Whether deletion succeeded
Error	Error message if request failed

Possible use case

Removing outdated or incorrect comments from tasks/projects.