NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Todoist

todoist

Todoist is a task management tool allowing users to create to-do lists, set deadlines, and collaborate on projects with reminders and cross-platform syncing

Task ManagementProductivityWeb del proveedor
Acciones
31
Triggers
1
Autenticación
—
OAuth gestionado
Sí
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (31)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Add WorkspaceTODOIST_ADD_WORKSPACEAcción

Tool to create a new workspace in todoist. use when you need a separate workspace to organize projects. generates uuid and temp id automatically.

Parámetros de entrada

  • iconstring

    Icon for the workspace (optional).

  • namestringObligatorio

    Name of the new workspace.

  • uuidstring

    UUID for this command for idempotency. If omitted, a new UUID is generated.

  • colorinteger

    Color ID for the workspace (optional).

  • temp_idstring

    Temporary identifier to map the command to the created resource. If omitted, a new UUID is generated.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Close TaskTODOIST_CLOSE_TASKAcción

This tool marks an existing task as completed in todoist. it requires the `task id` of the task to be closed.

Parámetros de entrada

  • task_idstringObligatorio

    The ID of the task to close.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create CommentTODOIST_CREATE_COMMENTAcción

Tool to create a new comment in todoist. use when you need to add a note to a specific task or project after confirming its id.

Parámetros de entrada

  • contentstringObligatorio

    The content of the comment.

  • task_idstring

    The ID of the task to attach the comment to. Required if project_id is not provided.

  • project_idstring

    The ID of the project to attach the comment to. Required if task_id is not provided.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create LabelTODOIST_CREATE_LABELAcción

Creates a new label.

Parámetros de entrada

  • namestringObligatorio

    Name of the label.

  • colorintegerenum

    Color of the label. See https://developer.todoist.com/guides/#colors for available colors.

    303132333435363738394041+8
  • orderinteger

    The order of the label in the list.

  • is_favoriteboolean

    Whether the label is a favorite.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create ProjectTODOIST_CREATE_PROJECTAcción

Creates a new project in todoist.

Parámetros de entrada

  • namestringObligatorio

    Name of the project.

  • colorstringenum

    Enum for project colors. Names are based on Todoist's standard palette.

    berry_redredorangeyellowolive_greenlime_greengreenmint_greentealsky_bluelight_blueblue+8
  • favoriteboolean

    Whether the project should be marked as a favorite.

  • parent_idstring

    ID of the parent project to create a sub-project. If not set, it's a top-level project.

  • view_stylestringenum

    Enum for project view styles.

    listboard

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create SectionTODOIST_CREATE_SECTIONAcción

Tool to create a new section within a specific project. use when you need to group tasks under a new heading in a project.

Parámetros de entrada

  • namestringObligatorio

    Name of the new section.

  • orderinteger

    Position of this section within the project. Sections with lower values appear first.

  • project_idintegerObligatorio

    ID of the project to create the section in.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create taskTODOIST_CREATE_TASKAcción

Create a new task in todoist. this action allows users to create tasks with various parameters including content, due dates, priority, and more. the task can be created in a specific project, section, or as a subtask of another task.

Parámetros de entrada

  • orderinteger

    Non-zero integer value used to sort tasks under the same parent.

  • labelsstring[]

    The task's labels (list of names for personal/shared labels).

  • contentstringObligatorio

    Task content/title. Can contain markdown-formatted text and hyperlinks.

  • due_datestring

    Specific date in YYYY-MM-DD format relative to user's timezone.

  • due_langstring

    2-letter code specifying language if due_string is not in English.

  • durationinteger

    Positive integer for task duration amount.

  • priorityinteger

    Task priority from 1 (normal) to 4 (urgent).

  • parent_idstring

    Parent task ID.

  • due_stringstring

    Human defined task due date (e.g., 'next Monday', 'Tomorrow'). Value is set using local time.

  • project_idstring

    Project ID of the task. If not set, task is put to user's Inbox.

  • section_idstring

    ID of section to put task into.

  • assignee_idstring

    The responsible user ID (only for shared tasks).

  • descriptionstring

    Task description. Can contain markdown-formatted text and hyperlinks.

  • due_datetimestring

    Specific date and time in RFC3339 format in UTC.

  • duration_unitstring

    Unit for duration - either 'minute' or 'day'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete LabelTODOIST_DELETE_LABELAcción

Tool to delete a specific label. use when you need to permanently remove an unused label by its id after confirming it's not in use. example: "delete label with id 2298391482".

Parámetros de entrada

  • label_idstringObligatorio

    The ID of the label to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete ProjectTODOIST_DELETE_PROJECTAcción

Tool to delete a specific todoist project. use when you need to permanently remove a project by its id.

Parámetros de entrada

  • project_idstringObligatorio

    The ID of the project to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete SectionTODOIST_DELETE_SECTIONAcción

Tool to delete a specific section. use when you need to permanently remove an unused section by its id after confirming it's not in use. example: "delete section with id 82181370".

Parámetros de entrada

  • section_idstringObligatorio

    The ID of the section to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete taskTODOIST_DELETE_TASKAcción

Delete a task from todoist. this action permanently removes the task and all its subtasks.

Parámetros de entrada

  • task_idstringObligatorio

    The ID of the task to delete.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get All CommentsTODOIST_GET_ALL_COMMENTSAcción

This tool retrieves all comments associated with a specific task or project in todoist. it requires either a task id or a project id to fetch the comments, and it returns a json array of comment objects with details such as id, posted at, content, and attachment information.

Parámetros de entrada

  • task_idstring

    The ID of the task for which to retrieve comments.

  • project_idstring

    The ID of the project for which to retrieve comments.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get all labelsTODOIST_GET_ALL_LABELSAcción

Get all personal labels from todoist. this action retrieves all personal labels from a user's todoist account. each label contains information like name, color, order and favorite status. api documentation: https://developer.todoist.com/rest/v2/#get-all-personal-labels

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get all projectsTODOIST_GET_ALL_PROJECTSAcción

Get all projects from a user's todoist account. this tool retrieves all projects from the authenticated user's todoist account. the response includes details like project id, name, color, parent project, sharing status, and other metadata for each project.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get All SectionsTODOIST_GET_ALL_SECTIONSAcción

Tool to retrieve all sections for a specific project in todoist. use when you need to list section structure within a project after selecting the project.

Parámetros de entrada

  • project_idstringObligatorio

    The ID of the project to retrieve sections from.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get All TasksTODOIST_GET_ALL_TASKSAcción

Fetches all tasks from todoist and returns their details.

Parámetros de entrada

  • idsinteger[]

    List of task IDs to retrieve.

  • langstring

    Language code for parsing date/times in queries.

  • filterstring

    Filter tasks based on filter query (same as UI).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get BackupsTODOIST_GET_BACKUPSAcción

Tool to list all available backup archives for the user. use when you need to retrieve and review all existing backups.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get CommentTODOIST_GET_COMMENTAcción

Tool to retrieve details of a specific comment by its comment id. use when you need full information (content, timestamp, or attachment) about a known comment.

Parámetros de entrada

  • comment_idstringObligatorio

    The ID of the comment to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get LabelTODOIST_GET_LABELAcción

Tool to retrieve a specific label by its id. use when you need detailed info about a label after you have its id.

Parámetros de entrada

  • idstringObligatorio

    The ID of the label to retrieve (numeric string).

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get ProjectTODOIST_GET_PROJECTAcción

Tool to retrieve a specific project by its id. use when you have a project id and need its metadata before display or update.

Parámetros de entrada

  • project_idstringObligatorio

    The ID of the project to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get SectionTODOIST_GET_SECTIONAcción

Tool to retrieve a specific section by its id. use when you have a section id and need its metadata before display or update.

Parámetros de entrada

  • section_idstringObligatorio

    The ID of the section to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Special BackupsTODOIST_GET_SPECIAL_BACKUPSAcción

Tool to list special backup archives for the user. use when you need to retrieve all project backups for the authenticated user after creating or managing projects.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get TaskTODOIST_GET_TASKAcción

Tool to retrieve a specific task by its id. use when you need to fetch all details of an existing task before processing or display.

Parámetros de entrada

  • task_idstringObligatorio

    The ID of the task to retrieve.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Archived Workspace ProjectsTODOIST_LIST_ARCHIVED_WORKSPACE_PROJECTSAcción

Tool to list all archived projects in a workspace. use when you need to retrieve archived workspace projects with optional filters or pagination.

Parámetros de entrada

  • limitinteger

    Limit the number of returned projects.

  • sincestring

    Return archived projects updated after this datetime (ISO 8601).

  • untilstring

    Return archived projects updated before this datetime (ISO 8601).

  • offsetinteger

    Offset for pagination.

  • project_idsstring[]

    List of project IDs to filter the results.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List FiltersTODOIST_LIST_FILTERSAcción

Tool to list all filters for the authenticated user. use when you need to retrieve the current set of custom filters.

Parámetros de entrada

  • sync_tokenstring

    Token for incremental sync. Use '*' for full sync.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Pending Workspace InvitationsTODOIST_LIST_PENDING_WORKSPACE_INVITATIONSAcción

Tool to list pending invitation emails in a workspace. use when you need to check which email invites are still pending acceptance in a workspace.

Parámetros de entrada

  • workspace_idstringObligatorio

    ID of the workspace to list pending invitations for.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Reopen TaskTODOIST_REOPEN_TASKAcción

This tool reopens a previously completed task.

Parámetros de entrada

  • task_idstringObligatorio

    The ID of the task to reopen.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update CommentTODOIST_UPDATE_COMMENTAcción

Tool to update a specific comment's content. use when you need to correct or clarify an existing comment after confirming its id and the new text.

Parámetros de entrada

  • contentstringObligatorio

    New text content for the comment.

  • comment_idstringObligatorio

    The ID of the comment to update.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update ProjectTODOIST_UPDATE_PROJECTAcción

Tool to update a specific project's attributes such as name, color, indent, and order. use when you need to rename or reorder a project after reviewing its current settings. example: "update project 2203306141 name to 'q1 goals'."

Parámetros de entrada

  • namestring

    New name for the project.

  • colorinteger

    New color ID for the project.

  • orderinteger

    New order position for the project.

  • indentinteger

    New indent level for the project (1-4).

  • project_idstringObligatorio

    The ID of the project to update.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update SectionTODOIST_UPDATE_SECTIONAcción

Tool to update a specific section's attributes such as name and order. use when you need to rename or reorder a section after confirming its id.

Parámetros de entrada

  • namestring

    New name for the section. If omitted, the name remains unchanged.

  • orderinteger

    New position of the section within its project (0 is first).

  • section_idstringObligatorio

    The ID of the section to update.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update TaskTODOIST_UPDATE_TASKAcción

Tool to update an existing task's properties. use when you need to modify a task's details after confirming its id and new values.

Parámetros de entrada

  • contentstring

    New content for the task.

  • task_idstringObligatorio

    The ID of the task to update.

  • due_datestring

    Due date in YYYY-MM-DD format.

  • due_langstring

    Language code for parsing `due_string`, e.g., 'en'.

  • priorityinteger

    Task priority from 1 (normal) to 4 (urgent).

  • label_idsinteger[]

    List of label IDs to assign to the task.

  • due_stringstring

    Human-readable due date string, e.g., 'tomorrow at 12:00'.

  • assignee_idstring

    User ID to assign the task to.

  • descriptionstring

    New description for the task.

  • due_datetimestring

    Due date and time in RFC3339 format.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Triggers (1)

Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).

New Task CreatedTODOIST_NEW_TASK_CREATEDTrigger

Trigger when a new task is added to Todoist.

Configuración

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • project_idstring

    (Optional) Filter new tasks by project ID.

Payload del evento

  • event_typestring

    Type of event

  • taskobjectObligatorio

    The Todoist task object

Instrucciones

Triggers when a new task is created in your Todoist account. If you provide a project_id, only tasks in that project will trigger the event. You can get your project ID by retrieving all projects using the Get All Projects action.