Recherche

Créer votre propre application avec l'API ClickUp

Vous voulez créer une application qui s'intègre à ClickUp ? Donnez à vos utilisateurs la possibilité de se connecter en utilisant OAuth 2.0!

N'oubliez pas de consulter également notre documentation API.

Ce dont vous aurez besoin

  • L'API ClickUp est disponible avec tous les forfaits ClickUp.
  • Un propriétaire ou administrateur de l'environnement de travail devra créer une application dans votre environnement de travail ClickUp.

Flux OAuth 2

Lorsque vous souhaitez développer une application que d'autres peuvent utiliser, il vous faut un flux d'authentification OAuth2.

Avec OAuth 2, chaque utilisateur de votre application se voit attribuer un jeton individualisé. Chaque utilisateur ne peut accéder qu'au contenu disponible pour son compte utilisateur ClickUp individuel.

Si vousne connaissez pas OAuth2, Digital Ocean a rédigé un excellent guide pour vous aider à démarrer. Nous vous recommandons également de consulter le site web d'OAuth pour plus de détails.

Créer une application

La première étape pour utiliser OAuth 2 est de créer une application dans votre environnement de travail.

Vous devez être propriétaire ou administrateur d'un environnement de travail pour gérer les paramètres d'intégration. Pour ce faire :

  1. Dans le coin inférieur gauche, cliquez sur l'avatar de votre environnement de travail.
  2. Sélectionnez Intégrations.
  3. Cliquez sur API ClickUp.
    • Saisissez le nom de votre application et une ou plusieurs URL de redirection.

      Vous ne savez pas quelle URL de redirection utiliser? Consultez ce guide sur le site web d'OAuth.

  4. Cliquez sur Créer une application.
  5. Sur l'écran suivant, vous verrez un Client ID et un Client Secret.
  6. Utilisez le Client ID et le Client Secret dans votre application pour créer un flux d'authentification OAuth 2.
Capture d'écran du modal de l'application utilisant OAuth2.

Modifiez 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. Dans le coin inférieur gauche, cliquez sur l'avatar de votre environnement de travail.
  2. Sélectionnez Intégrations.
  3. Cliquez sur API ClickUp.
  4. Développez l'application pour afficher ses détails.
  5. Mettez à jour votre application :
    • Ajoutez ou modifiez les URL de redirection.
    • Cliquez sur Enregistrer.

Voir ou régénérer votre secret client

Vous souhaitez régénérer votre secret client ? Vous pouvez le faire à tout moment.
  1. Cliquez sur l'avatar de votre environnement de travail dans le coin inférieur gauche
  2. Sélectionnez Intégrations
  3. Cliquez sur API ClickUp
  4. Développez l'application pour afficher ses détails
  5. Cliquez sur Afficher pour voir votre Client Secret actuel
  6. Cliquez sur Régénérer pour créer immédiatement un nouveau Client Secret
  7. Mettez à jour votre application pour utiliser le nouveau Client Secret

Types de jetons d'autorisation

Les jetons vous permettent d'effectuer des appels API et de vous intégrer à d'autres applications. Vous pouvez également utiliser des applications comme Make pour créer des intégrations sans écrire de code. Les jetons sont spécifiques à votre compte utilisateur ClickUp.

Toute personne possédant 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éés ou rejoints. Votre jeton personnel vous donne le même accès que via un navigateur web.

Si vous utilisez OAuth2, vous pouvez choisir d'autoriser l'accès à des environnements de travail spécifiques lorsque vous vous authentifiez pour la première fois ou lorsque vous vous ré-authentifiez ultérieurement.

Capture d'écran de quelqu'un sélectionnant les espaces de travail à autoriser avec OAuth2.

Mise à jour

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