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 |
Connection Setup
Connect Todoist to ByteChef using OAuth 2.0 (Authorization Code).
Create a Todoist OAuth app
- Open the Todoist App Management Console.
- Click on Add new integration.
- Enter an app name (for example,
ByteChef Integration). Click Create App. - Add the ByteChef OAuth redirect (callback) URL(s):
- Cloud:
https://app.bytechef.io/callback - Local development:
http://127.0.0.1:5173/callback
- Cloud:
- Click Save settings.
- Copy the Client ID and Client secret.
Actions
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 Optionsberyy_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 Optionstrue, 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" : ""
}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 Options1, 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.
What to do if your action is not listed here?
If this component doesn't have the action you need, you can use Custom Action to create your own. Custom Actions empower you to define HTTP requests tailored to your specific requirements, allowing for greater flexibility in integrating with external services or APIs.
To create a Custom Action, simply specify the desired HTTP method, path, and any necessary parameters. This way, you can extend the functionality of your component beyond the predefined actions, ensuring that you can meet all your integration needs effectively.
How is this guide?
Last updated on