Gestion de projet
ClickUp dans votre produit et vos agents IA, via une API
Le toolkit ClickUp couvre les Workspaces, Spaces, Folders, Lists, tâches et commentaires de tâches. Votre client autorise ClickUp une fois via OAuth, et votre produit ou agent IA appelle chaque opération via Connect, qui stocke et renouvelle les identifiants et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/clickup_create_list/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"folder_id": "<folder_id>",
"name": "<name>"
}
}Fonctionnement
Du client connecté au premier appel à ClickUp.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte ClickUp. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec ClickUp.
Transformer les tickets en tâches
Quand une demande de support ou une affaire atteint un état dans votre produit, créez une tâche dans la bonne List avec des assignés et une échéance.
Synchroniser le statut des tâches
Recherchez les tâches d'un Workspace par date et mettez à jour leur statut, pour que votre produit affiche ce qui est dû cette semaine et marque le travail comme terminé.
Un assistant de projet IA
Laissez un agent IA parcourir Spaces et Lists, lire une tâche avec ses checklists et publier des commentaires, sans écrire l'intégration ClickUp.
Tools
14 tools ClickUp
- Lister les workspacesGETListe les Workspaces (appelés teams dans l'API v2) que l'utilisateur a autorisés pour la connexion, chacun avec son id et ses membres. Les ids utilisateur des membres sont ceux que prennent les arguments assignee.
- Lister les spacesGETListe les Spaces d'un Workspace, avec les statuts de tâche que chaque Space définit. Les noms de statut sont ceux que prennent les arguments status des outils de tâche.
- Lister les foldersGETListe les Folders d'un Space. Les sous-folders arrivent dans la même liste à plat, avec parent_folder contenant l'id du Folder dans lequel ils se trouvent.
- Lister les listsGETListe les Lists d'un Folder. Les Lists situées directement dans un Space, hors de tout Folder, viennent de List folderless lists.
- Lister les lists sans folderGETListe les Lists situées directement dans un Space, hors de tout Folder.
- Créer une listPOSTCrée une List dans un Folder. Exige name. La List reprend les statuts de tâche de son Folder ou Space.
- Lister les tâchesGETListe les tâches dont l'origine est une List, jusqu'à 100 par page, sans les tâches fermées ni les sous-tâches sauf demande. Parcourez avec page tant que last_page dans la réponse est false. Les dates sont en Unix time en millisecondes.
- Rechercher des tâchesGETRecherche les tâches de tout un Workspace par date, comme celles dues cette semaine dans toutes les Lists, jusqu'à 100 par page et sans les tâches fermées sauf demande. Parcourez avec page jusqu'à ce qu'une réponse contienne moins de 100 tâches. Les dates sont en Unix time en millisecondes.
- Obtenir une tâcheGETRenvoie une tâche avec son statut, ses assignés, ses dates, ses tags, les valeurs de champs personnalisés, ses checklists et ses pièces jointes.
- Créer une tâchePOSTCrée une tâche dans une List. Exige name. ClickUp notifie les assignés et les observateurs, et aussi le créateur quand notify_all vaut true. Les dates sont en Unix time en millisecondes.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/clickup, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
Questions sur le toolkit ClickUp
Dois-je intégrer l'API ClickUp moi-même ?
Non. Connect fournit 14 tools ClickUp décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte ClickUp ?
Avec le mode accepté par le toolkit : OAuth avec l'app de votre produit. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
