Intégration Todoist n8nAutomatiser Todoist avec n8n.

Fermer une tâche depuis un workflow revient à cocher la case dans l'application : la tâche sort de la liste active et disparaît des filtres.

• Task ID : l'identifiant de la tâche à fermer, le plus souvent récupéré d'un nœud précédent avec {{ $json.id }}.

La version structurée de l'ajout : chaque champ est renseigné explicitement au lieu d'être deviné dans une phrase, ce qui donne un résultat prévisible quand les données viennent d'un autre système.

• Project Name or ID : le projet de destination, choisi dans la liste ou passé sous forme d'identifiant.
• Content : le texte de la tâche.
• Additional Fields : 13 champs optionnels, dont Due String (une échéance écrite en clair, interprétée en heure locale), Due Date au format YYYY-MM-DD, Priority de 1 (normale) à 4 (urgente) et Assignee ID pour une tâche partagée.

La suppression est définitive et le nœud n'offre aucune opération pour revenir en arrière. Elle se réserve aux workflows de nettoyage.

• Task ID : la tâche à supprimer, souvent l'identifiant conservé au moment de sa création.

Une tâche revient avec ses champs. De quoi vérifier l'état réel avant de décider de la suite, au lieu d'agir à l'aveugle sur un identifiant récupéré deux étapes plus tôt.

• Task ID : l'identifiant de la tâche à lire, souvent extrait d'un message ou d'une ligne de base de données avec {{ $json.taskId }}.

C'est l'opération de reporting du nœud : un appel, toutes les tâches qui correspondent, prêtes à être comptées, mises en forme ou exportées.

• Return All : activé, n8n enchaîne les pages de l'API et ramène tout ; désactivé, Limit fixe le nombre de tâches renvoyées.
• Filters : Filter accepte n'importe quel filtre supporté par Todoist, tandis que Project Name or ID, Section Name or ID, Label Name or ID et IDs (liste à virgules) resserrent encore le résultat.
• Lang : la langue dans laquelle le filtre est écrit, quand ce n'est pas l'anglais.

Déplacer ne touche pas au contenu : même tâche, même identifiant, nouveau projet, et au besoin une nouvelle section à l'intérieur.

• Task ID : la tâche à déplacer.
• Project Name or ID : le projet de destination, obligatoire même quand seule la section change.
• Section Name or ID : facultatif, la section d'arrivée.

Quick Add analyse une phrase comme le fait l'application : ce qui s'écrit en une ligne devient une tâche complète.

• Text : la phrase à interpréter. L'échéance s'écrit en clair, un projet commence par #, un label par @, un assigné par +, une priorité s'écrit p1, une deadline se place entre {}, et tout ce qui suit // devient la description.
• Additional Fields : Note ajoute le contenu d'une note, Reminder prend une date écrite en clair et Auto Reminder ajoute le rappel par défaut quand l'échéance porte une heure.

L'inverse de Close : une tâche terminée repasse en actif et réapparaît dans les filtres comme dans les récapitulatifs.

• Task ID : la tâche fermée à rouvrir.

Seuls les champs remplis partent dans l'appel, donc le workflow pousse une nouvelle échéance ou une nouvelle priorité sans réécrire la tâche.

• Task ID : la tâche à modifier.
• Update Fields : Content et Description pour le texte, Due String, Due Date ou Due Date Time pour la date, plus Priority, Label Names, Assignee ID et Deadline Date au format YYYY-MM-DD.

L'archivage sort le projet de la liste active sans rien supprimer de ce qu'il contient. C'est le geste de fin de mission.

• Project ID : le projet à archiver, accepté sous forme de chaîne ou de nombre.

Chaque client, campagne ou sprint peut recevoir son conteneur, créé par le workflow avec la même règle de nommage à chaque fois.

• Name : le nom du projet.
• Additional Fields : Color pioche dans la palette Todoist (berry_red, teal, lavender et les autres), Parent ID le range sous un projet existant, Is Favorite l'épingle et View Style l'ouvre en list ou en board.

Supprimer un projet ne se rattrape pas depuis le nœud : aucune opération ne le restaure, et n8n ne garde pas de copie de ce qu'il contenait. L'étape a sa place derrière une validation humaine, pas dans une branche automatique.

• Project ID : le projet à supprimer, en chaîne comme en nombre.

Transformer un identifiant en fiche lisible, voilà le rôle de cette lecture : un projet en entrée, ses données en sortie.

• Project ID : le projet à lire, en chaîne comme en nombre.

Les personnes qui partagent un projet s'obtiennent ici, et nulle part ailleurs dans le nœud. C'est la seule opération qui répond à la question « qui » plutôt qu'à la question « quoi ».

• Project ID : le projet partagé à inspecter, en chaîne comme en nombre.

Un appel, tous les projets du compte. L'opération ne prend aucun paramètre : ni filtre, ni pagination, rien à configurer, c'est le nœud suivant qui trie, compte ou filtre le résultat.

Un projet archivé revient parmi les actifs. C'est le pendant d'Archive, et le moyen le plus rapide de rouvrir un dossier clos trop tôt.

• Project ID : le projet archivé à réactiver.

Renommer, recolorer ou épingler un projet passe par cette opération, et seuls les champs renseignés voyagent.

• Project ID : le projet à modifier.
• Update Fields : Name, Color, Is Favorite et View Style (list ou board).

Les sections découpent un projet en étapes, et les créer depuis un workflow donne à chaque nouveau projet la même structure.

• Project Name or ID : le projet auquel la section est ajoutée.
• Name : le nom de la section.
• Additional Fields : Order fixe sa position parmi les autres.

Supprimer une section modifie la structure du projet, donc l'opération sert plutôt à nettoyer un gabarit qu'à tourner tous les jours.

• Section ID : la section à supprimer, en général lue par Get many sections plus tôt dans l'exécution.

Vérifier qu'un identifiant de section pointe toujours sur quelque chose, voilà l'usage concret de cette lecture, et la fiche renvoyée donne son nom au nœud suivant.

• Section ID : la section à lire.

Les sections reviennent sous forme de liste, sur tout le compte ou dans un seul projet, ce qui donne au workflow la carte dont il a besoin avant de déplacer quoi que ce soit.

• Filters : Project Name or ID limite la liste à un projet, choisi dans la liste ou passé par une expression.

Le nœud n'expose qu'un seul champ modifiable sur une section : son nom. Rien d'autre ne se change depuis un workflow.

• Section ID : la section à renommer.
• Update Fields : Name, le nouveau nom de la section.

Un commentaire vient se poser sous une tâche Todoist qui existe déjà, et le nœud le renvoie avec son propre identifiant.

• Task ID : la tâche qui reçoit le commentaire. Tu la récupères presque toujours du nœud précédent avec une expression, la syntaxe n8n qui va chercher une valeur dans l'item entrant, du type {{ $json.id }}.
• Content : le texte du commentaire, souvent construit à partir des données reçues (un numéro de commande, la réponse à un formulaire).

Supprime définitivement un commentaire, et le nœud ne renvoie que la confirmation : ce qui mérite d'être gardé se lit avant l'appel, avec Get a comment.

• Comment ID : l'identifiant du commentaire lui-même, pas celui de la tâche. Il vient de Get many comments, ou de l'étape qui a écrit le commentaire plus tôt dans la même exécution.

À partir d'un identifiant, l'opération va chercher un commentaire précis et passe son contenu aux nœuds suivants.

• Comment ID : l'identifiant du commentaire à lire. Enchaîne l'opération après Get many comments quand le workflow doit d'abord retrouver le bon.

Cette fois, le nœud renvoie une liste de commentaires plutôt qu'un seul, et l'un des deux filtres ci-dessous en fixe le périmètre : une tâche précise, ou tout un projet.

• Task ID : dans Filters, ne garde que les commentaires d'une seule tâche.
• Project ID : dans Filters, élargit la lecture à tous les commentaires d'un projet.

Réécrit le texte d'un commentaire déjà publié. Une tâche qui rend compte du même traitement trois fois par jour reste lisible : le statut tient sur une ligne au lieu de s'empiler.

• Comment ID : le commentaire à réécrire, conservé depuis l'exécution qui l'a créé.
• Content : dans Update Fields, le nouveau texte. Il prend la place de l'ancien, donc le workflow envoie la ligne complète, pas seulement ce qui a bougé.

Crée le label, et surtout renvoie son identifiant : c'est lui que les étapes suivantes vont réutiliser.

• Name : le nom du label, seul champ obligatoire.
• Color : dans Additional Fields, une liste fermée de valeurs nommées comme sky_blue, olive_green ou magenta. On choisit une couleur dans la liste, on n'écrit jamais un code hexadécimal.
• Order : la position du label dans la liste ; Is Favorite le passe en favori.

Le label quitte le compte et rien ne le ramène : la seule issue est de le recréer avec Create a label.

• Label ID : l'identifiant du label, celui que renvoie Get many labels. Le nom seul ne suffit pas.

Consulte un label précis et rend ce que Todoist en garde aujourd'hui.

• Label ID : l'identifiant du label consulté, stocké par l'étape qui l'a créé ou repris d'une lecture de liste.

Tous les labels du compte reviennent d'un coup, sans rien à régler avant. Un workflow qui les lit travaille ensuite sur des identifiants stables, pas sur des noms que quelqu'un a pu changer entre-temps.

Modifie un label sans le recréer. Seuls les champs ajoutés dans Update Fields partent vers Todoist, donc la couleur change sans toucher au nom.

• Label ID : le label concerné.
• Name : son nouveau nom.
• Color : une des valeurs de la liste, red ou lavender par exemple, quand le sens du label change.
• Order et Is Favorite : remontent le label dans la liste ou le placent dans les favoris.

Une tâche existante reçoit un rappel, et c'est Todoist qui prévient au moment voulu.

• Task ID : la tâche qui porte le rappel.
• Due Date Type : la façon d'écrire ce moment, chaque choix ouvrant son champ : natural_language avec Natural Language Representation (tomorrow 2pm), full_day avec Date au format YYYY-MM-DD, floating_time avec Date Time sans fuseau, fixed_timezone avec Timezone comme America/New_York.
• Minute Offset : dans Additional Fields, déclenche un rappel relative autant de minutes avant l'échéance ; Notify User ID désigne qui prévenir sur une tâche partagée.

Décroche un rappel d'une tâche sans rien changer d'autre : la tâche reste en place, seule la notification prévue disparaît.

• Reminder ID : l'identifiant du rappel, renvoyé par Get many reminders ou par l'étape qui l'a posé.

Aucun paramètre à remplir : le nœud rapporte tous les rappels du compte, tels quels. Il ne propose aucun filtre non plus, donc le tri se fait dans les nœuds qui suivent.

Plutôt que de supprimer un rappel pour en recréer un autre, l'opération le déplace ou le réajuste là où il est, sans perdre le lien avec la tâche.

• Reminder ID : le rappel à modifier.
• Due : dans Update Fields, contient le nouveau moment de déclenchement.
• Type et Minute Offset : basculent entre absolute et relative, ou changent le nombre de minutes avant l'échéance de la tâche ; Notify User ID confie le rappel à quelqu'un d'autre.