Intégration ClickUp n8nAutomatiser ClickUp avec n8n.

Ajoute une checklist à une tâche existante et donne au workflow un endroit où écrire les étapes suivantes. Elle apparaît dans la tâche, sous son propre titre.

• Task ID : la tâche qui reçoit la checklist, souvent {{ $json.id }} quand un nœud de tâche tourne juste avant.
• Name : le titre de la checklist, là où on met en général la phase ou le responsable.

Fait sauter une checklist entière de sa tâche, lignes comprises. Rien n'est archivé, donc l'opération se place en bout de branche, sur un cas que tu maîtrises.

• Checklist ID : l'identifiant de la checklist elle-même, pas celui de la tâche qui la porte, nuance à vérifier deux fois dans le mapping.

Deux choses bougent sur une checklist existante : son intitulé et sa place parmi les autres checklists de la tâche. Les lignes, elles, ne sont pas touchées.

• Checklist ID : la checklist à modifier.
• Name : dans Update Fields, le nouvel intitulé.
• Position : dans Update Fields, un nombre qui fixe son rang dans la tâche.

Écrit une ligne dans une checklist déjà en place et, si besoin, l'attribue à quelqu'un dans le même appel.

• Checklist ID : la checklist qui reçoit la ligne.
• Name : le texte de la ligne, formulé comme une action à faire plutôt que comme un thème.
• Assignee ID : dans Additional Fields, l'utilisateur ClickUp qui en est responsable.

Retire une seule ligne et laisse le reste de la checklist en place. Les deux identifiants sont obligatoires, la checklist parente et la ligne visée.

• Checklist ID : la checklist à laquelle la ligne appartient.
• Checklist Item ID : la ligne à supprimer.

Modifie une ligne sans la recréer : nouveau texte, nouveau responsable, cochée ou décochée, ou rangée sous une autre ligne en sous-étape.

• Checklist ID et Checklist Item ID : la ligne à modifier et la checklist qui la contient.
• Resolved : dans Update Fields, le booléen qui coche la case.
• Parent Checklist Item ID : dans Update Fields, imbrique la ligne sous une autre ligne de la checklist.

Poste un commentaire sur une tâche, une liste ou une vue, avec la possibilité de notifier tout le monde au passage.

• Comment On : le type de cible, task, list ou view.
• ID : l'identifiant de cette cible, donc celui d'une tâche quand Comment On vaut task.
• Comment Text : le corps du message.
• Notify All : dans Additional Fields, envoie la notification de création à tout le monde, auteur du commentaire compris.

Efface un commentaire de l'objet sur lequel il avait été posté. Seul son identifiant est demandé, et la suppression est définitive.

• Comment ID : le commentaire à retirer, conservé depuis l'étape qui l'a créé ou lu avec comment.getAll.

Lit les commentaires attachés à une tâche, une liste ou une vue, et les renvoie sous forme d'items que le nœud suivant peut parcourir.

• Comments On : le type d'objet lu, task, list ou view.
• ID : l'identifiant de cet objet.
• Limit : le nombre maximal de commentaires ramenés, utile quand un fil s'étire sur des mois.

Réécrit un commentaire existant sur place, le réattribue, ou le marque comme traité.

• Comment ID : le commentaire à modifier.
• Comment Text : dans Update Fields, le nouveau contenu.
• Resolved : dans Update Fields, marque le fil comme réglé.
• Assignee ID : dans Update Fields, bascule le commentaire sur un autre utilisateur ClickUp.

Crée un dossier dans un espace, le contenant qui accueillera ensuite les listes d'un projet.

• Team Name or ID : l'espace de travail. Les champs notés Name or ID lisent les valeurs de ton compte et les affichent dans une liste déroulante, et acceptent aussi un identifiant passé par une expression.
• Space Name or ID : l'espace qui reçoit le dossier.
• Name : le nom du dossier, souvent la référence du projet.

Supprime un dossier de son espace. Les trois champs de localisation doivent décrire le même chemin : équipe, puis espace, puis dossier.

• Team Name or ID et Space Name or ID : là où le dossier se trouve aujourd'hui.
• Folder Name or ID : le dossier à supprimer, choisi dans la liste ou fourni comme identifiant.

Renvoie un seul dossier. C'est le moyen le plus rapide de vérifier qu'il existe avant d'écrire quoi que ce soit dedans.

• Team Name or ID et Space Name or ID : le chemin jusqu'au dossier.
• Folder Name or ID : le dossier lu.

Liste les dossiers d'un espace et renvoie un item par dossier, les archivés inclus ou non selon le filtre.

• Space Name or ID : l'espace inspecté, dans l'équipe sélectionnée au-dessus.
• Limit : le plafond du nombre de dossiers renvoyés.
• Archived : dans Filters, le booléen qui décide si les dossiers archivés remontent également.

Change le nom d'un dossier. C'est le seul champ que cette opération modifie, rien d'autre ne bouge dans le dossier.

• Folder Name or ID : le dossier à renommer, dans l'équipe et l'espace visés.
• Name : dans Update Fields, le nouveau nom.

Ouvre un objectif dans l'espace de travail, avec ses porteurs, sa couleur et son échéance. Les résultats clés arrivent ensuite, par leur propre opération.

• Team Name or ID : l'équipe à laquelle l'objectif appartient.
• Name : l'objectif, formulé comme un résultat et pas comme une tâche.
• Due Date : dans Additional Fields, la date sur laquelle il sera jugé.
• Owners et Multiple Owners : dans Additional Fields, qui le porte, une personne ou plusieurs.

Sort un objectif de l'espace de travail. L'opération ne demande que son identifiant, à garder depuis l'étape qui l'a créé ou depuis une liste.

• Goal ID : l'objectif à supprimer.

Lit un objectif et le renvoie sous forme d'un item unique, ce qu'il faut avant de décider s'il mérite une mise à jour. Rien n'est écrit, c'est donc la moitié tranquille d'un duo lecture puis écriture.

• Goal ID : l'objectif à lire.

Liste les objectifs d'un espace de travail, un item par objectif, prêts à être filtrés ou comptés plus loin dans le workflow.

• Team Name or ID : l'équipe dont on liste les objectifs.
• Limit : le nombre maximal d'objectifs renvoyés, utile sur un espace qui en a accumulé des années.

Modifie un objectif déjà créé : nom, description, échéance, couleur, et les personnes dessus, ajoutées ou retirées par deux champs distincts.

• Goal ID : l'objectif à modifier.
• Due Date : dans Update Fields, la nouvelle échéance.
• Add Owners et Remove Owners : dans Update Fields, les arrivées et les départs se traitent séparément.

Accroche un résultat mesurable à un objectif. Le type choisi décide de ce qui est compté.

• Goal ID et Name : l'objectif auquel il se rattache, et ce qui est mesuré.
• Type : au choix automatic, boolean, currency, number ou percentage.
• Steps Start et Steps End : dans Additional Fields, requis pour les types Percentage, Automatic, Number et Currency, ils fixent la plage parcourue.
• Unit : dans Additional Fields, ne compte que pour Number et Currency, et pour Currency il faut un code devise valide.

Détache un résultat clé de son objectif et le supprime. L'objectif, lui, reste en place.

• Key Result ID : le résultat clé à retirer, à ne pas confondre avec l'identifiant de l'objectif.

Fait avancer un résultat clé existant, ou corrige sa description. C'est l'opération qu'un workflow planifié appelle le plus souvent, parce qu'un chiffre bouge plus vite qu'un objectif.

• Key Result ID : le résultat clé mis à jour.
• Steps Current : dans Update Fields, la valeur atteinte à ce stade.
• Steps Start et Steps End : dans Update Fields, la plage, le jour où la cible elle-même est revue.
• Note : dans Update Fields, un commentaire sur la mise à jour, utile quand le chiffre recule.

La liste est créée dans le dossier ClickUp visé, et l'opération renvoie son identifiant, que les nœuds suivants réutilisent pour y déposer des tâches.

• Space Name or ID : l'espace qui accueille la liste, choisi dans le menu déroulant ou calculé par une expression, c'est-à-dire une valeur lue dans le nœud précédent, par exemple {{ $json.space }}.
• Folderless List : laissé sur non, la liste atterrit dans le dossier choisi juste en dessous.
• Name : le titre de la liste, seul texte obligatoire ici.
• Priority : dans Additional Fields, un entier : 1 Urgent, 2 High, 3 Normal, 4 Low.

Dans ClickUp, les champs personnalisés se déclarent liste par liste. L'opération renvoie leur définition, donc l'identifiant à viser avant d'écrire quoi que ce soit sur une tâche.

• Team Name or ID : l'espace de travail, pris dans la liste déroulante ou fixé par une expression.
• List Name or ID : la liste dont tu veux les champs ; le menu se remplit une fois l'espace et le dossier renseignés.

Supprimer une liste la retire de l'espace avec ce qu'elle contient. Le nœud attend un identifiant, jamais un nom, et ne demande aucune confirmation.

• List ID : un champ texte à ce stade, le plus souvent {{ $json.id }} hérité d'une opération précédente.
• Folderless List : l'interrupteur compte toujours, puisqu'il indique au nœud où chercher la liste.

Une liste, une lecture. L'opération renvoie la fiche que ClickUp garde : titre, contenu, dates, statuts et dossier de rattachement.

• List ID : l'identifiant de la liste à lire, en texte.
• Folder Name or ID : le dossier dans lequel n8n va chercher, choisi dans le menu déroulant.

Toutes les listes d'un dossier arrivent en un appel, chacune avec son identifiant et ses dates.

• Folder Name or ID : le dossier à parcourir.
• Limit : le nombre maximal de listes renvoyées sur une exécution.
• Archived : dans Filters, l'interrupteur qui décide si les listes archivées rejoignent le résultat.

L'appartenance se lit au niveau de la liste. L'opération renvoie les personnes qui y ont accès, avec l'identifiant qu'attendent les autres opérations ClickUp.

• List ID : la liste à inspecter, saisie ou construite par une expression.
• Return All : activé, n8n enchaîne les pages jusqu'au dernier membre ; désactivé, seuls les premiers remontent.

Une liste existante se met à jour ici. Seul ce que tu places dans Update Fields bouge, le reste ne bronche pas.

• List ID : la liste à modifier.
• Name : dans Update Fields, le nouveau titre.
• Unset Status : dans Update Fields, retire le statut posé sur la liste.
• Priority : même correspondance qu'à la création, de 1 Urgent à 4 Low.

Un tag appartient à l'espace, pas à la tâche. L'opération le déclare, avec les deux couleurs qui le rendent lisible sur une carte.

• Space ID : l'espace où le tag est créé, en texte.
• Name : le libellé, et l'orthographe exacte que taskTag.add réclamera ensuite.
• Foreground Color : la couleur du texte, prise dans le sélecteur.
• Background Color : le fond derrière le libellé.

Le tag disparaît de l'espace. Les tâches qui le portaient restent en place, elles perdent simplement l'étiquette.

• Space ID : l'espace où vit le tag.
• Name or ID : le tag à retirer, sélectionné dans la liste que n8n charge depuis cet espace.

L'inventaire des tags d'un espace arrive en une fois, noms et couleurs compris.

• Space ID : l'espace à lire.
• Return All : coché, tous les tags reviennent, quel que soit leur nombre.
• Limit : le plafond quand Return All reste décoché.

Un tag change de nom ou de couleurs ici. L'opération demande le tag tel qu'il existe aujourd'hui et les nouvelles valeurs côte à côte.

• Name or ID : le tag à modifier, pris dans la liste de l'espace.
• New Name : le nom à lui donner.
• Foreground Color : la couleur de texte à appliquer.
• Background Color : la couleur de fond à appliquer.

La tâche apparaît dans la liste choisie et ressort avec son identifiant, que toutes les opérations ClickUp suivantes du workflow peuvent réutiliser.

• List Name or ID : la liste qui reçoit la tâche, au bout de la chaîne équipe, espace et dossier.
• Name : le titre de la tâche.
• Custom Fields JSON : dans Additional Fields, des valeurs au format [ {"id": "", "value": ""} ].
• Time Estimate : dans Additional Fields, une estimation exprimée en minutes.

Un identifiant, un effet : la tâche quitte ClickUp. Aucune collection optionnelle sur cette opération, rien d'autre à régler, et pas de retour en arrière depuis le workflow.

• Task ID : la tâche à supprimer, souvent {{ $json.id }} transmis par le nœud d'avant.

Lecture d'une tâche unique, avec deux interrupteurs qui changent le contenu de la réponse.

• Task ID : la tâche à lire.
• Include Subtasks : activé, les sous-tâches remontent avec elle.
• Include Markdown Description : activé, la réponse contient markdown_description, qui préserve les liens et la mise en forme de la description.

Les tâches d'une liste remontent par paquets, et c'est la collection Filters qui fait le vrai tri.

• List Name or ID : la liste à parcourir.
• Return All : activé, n8n suit les pages jusqu'à épuiser la liste.
• Include Closed : dans Filters, les tâches fermées restent hors réponse tant que cet interrupteur est éteint et qu'aucun filtre de statut n'est envoyé.
• Order By : dans Filters, tri sur id, created, updated ou dueDate.

Qui travaille sur cette tâche ? L'opération renvoie les membres que ClickUp affiche sur la carte.

• Task ID : la tâche à inspecter.
• Limit : le nombre maximal de membres renvoyés quand Return All reste décoché.

L'opération écrit une valeur dans un champ personnalisé d'une tâche. Le champ se désigne par son identifiant, celui que la lecture des champs de la liste a fourni.

• Task ID : la tâche qui porte le champ.
• Field ID : l'identifiant du champ personnalisé à remplir.
• Value : la valeur à poser.
• Value Is JSON : à activer quand le champ attend un tableau, les labels par exemple, pour que n8n analyse la valeur au lieu de l'envoyer en texte.

Modification sur place. Tout l'optionnel vit dans Update Fields, et ce que tu laisses vide garde sa valeur actuelle.

• Task ID : la tâche à modifier.
• Add Assignees : des identifiants d'assignés, séparés par une virgule quand il y en a plusieurs.
• Remove Assignees : même format, pour ceux qui quittent la tâche.
• Status : le statut à appliquer, saisi en texte.

Déclarer qu'une tâche en attend une autre se fait ici. ClickUp connaît alors l'ordre, et le workflow n'a pas à le garder dans une variable.

• Task ID : la tâche qui attend.
• Depends On Task ID : celle qui doit avancer en premier.

Le lien entre deux tâches saute et chacune redevient indépendante. Mêmes identifiants qu'à la création, dans le même ordre.

• Task ID : la tâche qui attendait.
• Depends On Task ID : celle qu'elle attendait.

Une tâche peut vivre dans plusieurs listes. L'opération rattache une tâche existante à une liste supplémentaire, sans la déplacer ni la dupliquer.

• Task ID : la tâche à rattacher.
• List ID : la liste qui l'accueille.

La tâche quitte une seule liste, celle que tu désignes, et reste dans les autres où elle figure. Rien n'est supprimé ici, seul le rattachement entre cette tâche et cette liste saute.

• Task ID : la tâche à détacher.
• List ID : la liste qu'elle quitte.

Un tag déjà présent dans l'espace se pose sur une tâche, par son nom.

• Tag Name : le tag orthographié exactement comme dans l'espace.
• Custom Task IDs : dans Additional Fields, permet de viser la tâche par son identifiant personnalisé plutôt que par celui de ClickUp.
• Team Name or ID : dans Additional Fields, lu uniquement quand Custom Task IDs est actif.

Un seul tag est retiré, les autres restent posés sur la tâche.

• Task ID : la tâche à nettoyer.
• Tag Name : le tag à enlever, avec la même orthographe que dans l'espace.
• Custom Task IDs : dans Additional Fields, l'interrupteur qui fait lire un identifiant de tâche personnalisé.

Écrit sur une liste un temps déjà passé, avec son point de départ et sa durée.

• Start et Duration (Minutes) : le moment où le travail a commencé, et le temps qu'il a pris, en minutes.
• Folderless List : précise si la liste visée est rangée hors dossier, pendant que Space Name or ID, Folder Name or ID et List Name or ID terminent le chemin sous Team Name or ID.
• Additional Fields : y vivent Billable, Description, Assignee Name or ID et Tag Names or IDs.

Efface définitivement une entrée de la feuille de temps. Seul son identifiant compte, peu importe la liste sur laquelle le temps avait été posé.

• Time Entry ID : l'identifiant de l'entrée à retirer, collé à la main ou lu sur l'item entrant avec une expression comme {{ $json.id }} (une expression, c'est la formule qui va chercher une valeur dans les données reçues).
• Team Name or ID : l'espace de travail qui contient l'entrée.

Lit une seule entrée et retourne ses valeurs telles qu'elles sont stockées, de quoi vérifier une durée avant d'enchaîner.

• Running : activé, le nœud ne renvoie que le chrono en cours.
• Time Entry ID : l'identifiant de l'entrée à consulter.
• Team Name or ID : l'espace de travail interrogé.

Les entrées s'accumulent vite sur un espace actif. L'opération les ramène sur une fenêtre de dates, une par item, prêtes à être additionnées.

• Filters : contient Start Date et End Date, les deux bornes de la période demandée.
• Return All : coché, n8n enchaîne les pages de l'API jusqu'à la dernière entrée ; décoché, Limit fixe le nombre d'items renvoyés.
• Team Name or ID : l'espace de travail dont on lit la feuille de temps.

Lance un chrono sur une tâche : le temps court dans ClickUp jusqu'à ce qu'une autre opération l'arrête.

• Task ID : un champ texte ici, pas une liste déroulante, donc l'identifiant de la tâche se saisit ou se reprend de l'item qui a déclenché le workflow.
• Additional Fields : Description dit ce que couvre le chrono, Billable le marque comme temps client dès la première minute.
• Team Name or ID : l'espace de travail concerné.

Aucun identifiant à fournir ici : l'opération arrête le chrono qui tourne dans l'espace de travail et laisse le reste de la feuille de temps intact.

• Team Name or ID : le seul champ à remplir, ce qui fait de cette opération l'une des plus rapides à brancher.

Corrige une entrée déjà enregistrée : durée fausse, temps posé sur la mauvaise tâche, case facturable oubliée.

• Time Entry ID et Archived : l'entrée à reprendre, et le booléen requis qui indique si elle est archivée.
• Update Fields : tout ce qui change, de Duration (Minutes) et Start à Task Name or ID, Assignee Name or ID, Billable, Description et Tag Names or IDs.
• List Name or ID : la liste de rattachement, atteinte via Space Name or ID, Folderless List et Folder Name or ID.

Pose un ou plusieurs tags sur des entrées existantes, ce qui permet de trier le temps plus tard sans toucher aux tâches.

• Time Entry IDs : le pluriel est volontaire, plusieurs identifiants passent en un appel et chaque entrée citée reçoit les mêmes tags.
• Tags : une collection où chaque ligne Add Tag décrit un tag à appliquer.
• Team Name or ID : l'espace de travail des entrées visées.

Trier le temps par tag ne marche que si tout le monde utilise les mêmes libellés. L'opération liste ceux qui existent déjà sur l'espace de travail.

• Return All : ramène la liste complète en enchaînant les pages ; sans lui, Limit décide combien de tags reviennent.
• Team Name or ID : l'espace de travail dont on lit les tags.

Retire des tags posés sur des entrées, sans toucher au temps enregistré dessus.

• Tag Names or IDs : les tags à décrocher, choisis dans la liste ou fournis par identifiant via une expression.
• Time Entry IDs : les entrées à nettoyer, plusieurs d'un coup.
• Team Name or ID : l'espace de travail concerné.