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.