> ## 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 te ayuda a crear y gestionar tareas, proyectos, secciones, etiquetas, comentarios y espacios de trabajo mediante tu cuenta conectada.

# Todoist

Usa Todoist cuando necesites crear, actualizar o consultar elementos de trabajo en un flujo de trabajo. También es útil cuando quieres organizar tareas en proyectos y secciones, añadir etiquetas o comentarios, y completar o reabrir tareas.

## Configuración

| Option | Required | Description |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta conectada de Todoist que se usará para este paso. |
| Action | Yes | La acción de Todoist que se va a realizar (por ejemplo Create task, Get task, Update task, Close task). |
| Arguments | Yes | Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta Todoist en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay ninguna conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Arguments form

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Common actions

| Action | Description |
| - | - |
| **Create task** | Crea una nueva tarea en Todoist. |
| **Get task** | Obtén una sola tarea activa por ID. |
| **Update task** | Actualiza las propiedades de una tarea existente. |
| **Close task** | Completa una tarea en Todoist. |
| **Reopen task** | Reabre una tarea completada. |
| **Create project** | Crea un nuevo proyecto en Todoist. |
| **Get project** | Obtén un proyecto por ID. |
| **Update project** | Actualiza las propiedades de un proyecto. |
| **Create section** | Crea una sección dentro de un proyecto. |
| **List sections** | Lista las secciones activas del usuario. |
| **Create label** | Crea una nueva etiqueta personal. |
| **List labels** | Lista todas las etiquetas del usuario. |
| **Create comment** | Crea un comentario en un proyecto o tarea. |
| **List comments** | Lista comentarios de una tarea o proyecto. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Output

Este paso guarda la respuesta de Todoist como la salida del paso. La forma de la respuesta depende de la acción.

Usa la referencia completa de salida en pasos posteriores:

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

## Example

1. Abre **Integrations** y conecta Todoist si aún no lo has hecho.
2. Añade un paso de **Todoist** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Create task** en **Action**.
5. Rellena los campos obligatorios. Usa **Insert Variable** para referenciar la salida de un paso anterior en cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa el payload devuelto en **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

* Este paso depende de una integración conectada de Todoist en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto seleccionado de acciones. Los agentes con la herramienta Todoist pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar una marca de autorización de terceros.

## Using Todoist as an Agent Tool

También puedes añadir Todoist como una herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **Todoist**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a las acciones de Todoist cuando son relevantes para la conversación.

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


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