> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Todoist

> Todoist helps you create and manage tasks, projects, sections, labels, comments, and workspaces via your connected account.

Use Todoist when you need to create, update, or look up work items in a workflow. It is also useful when you want to organize tasks into projects and sections, add labels or comments, and complete or reopen tasks.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected Todoist account to use for this step. |
| Action | Yes | The Todoist action to perform (for example Create task, Get task, Update task, Close task). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect Todoist in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Create task** | Create a new task in Todoist. |
| **Get task** | Get a single active task by ID. |
| **Update task** | Update an existing task's properties. |
| **Close task** | Complete a task in Todoist. |
| **Reopen task** | Reopen a completed task. |
| **Create project** | Create a new project in Todoist. |
| **Get project** | Get a project by ID. |
| **Update project** | Update a project's properties. |
| **Create section** | Create a section within a project. |
| **List sections** | List active sections for the user. |
| **Create label** | Create a new personal label. |
| **List labels** | List all user labels. |
| **Create comment** | Create a comment on a project or task. |
| **List comments** | List comments on a task or project. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the Todoist response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect Todoist if you have not already done that.
2. Add a **Todoist** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Create task** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Create a task from a form reply

1. Create task
2. Update task
3. Get task

### Organize work in a project

1. Create project
2. Create section
3. List sections
4. Update project

### Track collaboration comments

1. Create comment
2. List comments
3. Get project

## Notes

* This step depends on a connected Todoist integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the Todoist tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using Todoist as an Agent Tool

You can also add Todoist as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Todoist**. In the tool settings panel, choose the connected account the agent should use. The agent calls Todoist actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.