Créer votre propre application avec l’API ClickUp

Envie de créer une appli qui s’intègre avec ClickUp ? Donnez à vos utilisateurs la possibilité de se connecter avec OAuth 2.0 ! 
Pensez à lire notre document sur les API !

Ce dont vous aurez besoin

Flux OAuth 2

Lorsque vous souhaitez développer une application utilisable par d’autres personnes, vous devez utiliser un flux d’authentification OAuth 2.
Avec OAuth 2, chaque personne utilisant votre appli se voit attribuer un jeton individuel. Chaque utilisateur peut uniquement accéder au contenu disponible sur son compte ClickUp individuel.
Conseil : Si vous ne connaissez pas OAuth 2, Digital Ocean a rédigé un excellent guide qui vous aidera à vous lancer. Nous recommandons également de consulter le site Web d’OAuth pour plus d’informations.

Créer une application

La première étape pour utiliser OAuth consiste à créer une appli dans votre environnement de travail. Pour gérer les paramètres d’intégration, vous devez être propriétaire ou administrateur de l’environnement de travail. Voici comment procéder :
  1. Ouvrez vos paramètres personnels :
    • ClickUp 2.0 : dans le coin inférieur gauche, cliquez sur votre avatar. Sélectionnez Mes paramètres.
    • ClickUp 3.0 : dans le coin supérieur droit, cliquez sur votre avatar. Sélectionnez Paramètres
  2. Dans la barre latérale, cliquez sur API ClickUp.
  3. Cliquez sur + Créer une application.
  4. Saisissez le nom de votre application et une ou plusieurs URL de redirection.
    • Conseil : vous ne savez quoi utiliser comme URL de redirection ? Lisez ce guide sur le site Web d’OAuth.
  5. Cliquez sur Créer l’application.
  6. Sur l’écran suivant s’affichent un identifiant client et un secret client.
  7. Utilisez l’identifiant client et le secret client pour créer un flux d’authentification OAuth 2 dans votre appli.

Capture d’écran du modal de l’appli utilisation OAuth 2.

Mettre à jour vos URL de redirection

Vous avez une nouvelle URL de redirection ? Vous pouvez mettre à jour ces paramètres dans votre environnement de travail ClickUp à tout moment.
  1. Cliquez sur l’avatar de votre environnement de travail.
  2. Sélectionnez Intégrations.
  3. Cliquez sur API ClickUp.
  4. Déroulez l’application pour en afficher les informations.
  5. Mettez vos applications à jour :
    • Ajoutez ou mettez à jour les URL de redirection.
    • Cliquez sur Enregistrer.

Afficher votre secret client ou en générer un nouveau

Vous voulez générer un nouveau secret client ? C’est possible à tout moment.
  1. Cliquez sur l’avatar de votre environnement de travail.
  2. Sélectionnez Intégrations
  3. Cliquez sur API ClickUp
  4. Déroulez l’application pour en afficher les informations.
  5. Cliquez sur Afficher pour visualiser votre secret client actuel.
  6. Cliquez sur Régénérer pour créer immédiatement un nouveau secret client.
  7. Mettez votre application à jour pour utiliser le nouveau secret client.

Types de jetons d’autorisation

Les jetons vous permettent de réaliser des appels d’API et de l’intégrer avec d’autres applications. Vous pouvez également utiliser des applis comme Make pour créer des intégrations sans écrire de code. Les jetons sont spécifiques à votre compte utilisateur ClickUp.
Toute personne disposant d’un compte ClickUp peut générer un jeton personnel. Les jetons personnels permettent l’accès à tous les environnements de travail que votre compte a créé ou rejoint. Votre jeton personnel vous donne le même accès que celui d’un navigateur web.
Si vous utilisez OAuth 2, vous pouvez choisir d’autoriser l’accès à des environnements de travail spécifiques lorsque vous vous authentifiez pour la première fois, puis les fois suivantes.
Capture d’écran d’une personne sélectionnant quels environnements de travail autoriser avec OAuth 2.

Cet article vous a-t-il été utile ?