Búsqueda

Crea tu propia aplicación con la API de ClickUp

¿Quieres crear una aplicación que se integre con ClickUp? Ofrece a tus usuarios la posibilidad de iniciar sesión con OAuth 2.0. 
Y asegúrate también de revisar nuestra documentación sobre la API.

Qué necesitas

Flujo OAuth2

Si quieres desarrollar una aplicación que puedan usar otras personas, es imprescindible que incluyas un flujo de autenticación OAuth2.
Con OAuth 2, a cada usuario de tu app se le asigna un token individualizado. Los usuarios solo pueden acceder al contenido que está disponible para su cuenta de ClickUp.

Si no te defiendes con OAuth2, Digital Ocean ha elaborado una fantástica guía para ayudarte con los primeros pasos. También te recomendamos que consultes el sitio web de OAuth para obtener más información.

Crear una aplicación

El primer paso para usar OAuth2 es crear una aplicación en tu entorno de trabajo. Debes ser el propietario o administrador del entorno de trabajo para poder gestionar los ajustes de la integración.
Para crear una app en tu entorno de trabajo:
  1. Haz clic en el avatar de tu entorno de trabajo, situado en la esquina superior izquierda.
  2. Selecciona Ajustes. 
  3. En la barra lateral de todos los ajustes, selecciona ClickUp API.
  4. En la esquina superior derecha de la página de ajustes de ClickUp API, haz clic en Crear una App.Captura de pantalla del botón Crear una App.png
  5. Escribe el nombre de la aplicación y una URL de redireccionamiento.
    Si no estás seguro de qué usar para tu URL de redirección, consulta la guía de URLs de redirección en el sitio web de OAuth.
  6. Haz clic en Crear aplicación.
  7. En la siguiente pantalla, verás que se han generado un ID de cliente y un Secreto de cliente.
  8. Usa el ID de cliente y el secreto del cliente de tu aplicación para crear un flujo de autenticación OAuth2.

Captura de pantalla del cuadro de diálogo modal de la aplicación usando OAuth2.

Actualiza tu URL de redireccionamiento

Si tienes una URL de redireccionamiento nueva, puedes modificar estos ajustes en tu entorno de trabajo de ClickUp cuando quieras. Sigue estos pasos:
  1. Haz clic en el avatar de tu entorno de trabajo, situado en la esquina superior izquierda.
  2. Selecciona Ajustes. 
  3. En la barra lateral de todos los ajustes, selecciona ClickUp API.
  4. Haz clic en una aplicación existente para ver todos los detalles.
  5. Modifica la URL de redireccionamiento.
  6. Haz clic en Guardar.

Consulta o vuelve a generar tu secreto del cliente

Sigue estos pasos para volver a generar tu secreto del cliente:
  1. Haz clic en el avatar de tu entorno de trabajo, situado en la esquina superior izquierda.
  2. Selecciona Ajustes. 
  3. En la barra lateral de todos los ajustes, selecciona ClickUp API.
  4. Haz clic en una aplicación existente para ver todos los detalles.
  5. Haz clic en Mostrar para ver el secreto del cliente actual.
  6. Haz clic en Volver a generar para crear un secreto del cliente nuevo.
  7. Actualiza tu aplicación para usar el nuevo secreto del cliente.

Tipos de token de autorización

Los tokens te permiten hacer llamadas a API e integrar ClickUp con otras aplicaciones. También puedes usar apps como Make para crear integraciones sin escribir código. Los tokens son específicos de tu cuente de ClickUp.
Cualquier persona que tenga una cuenta de ClickUp puede generar un token personal. Los tokens personales dan acceso a todos los entornos de trabajo creados en tu cuenta o a los que te hayas unido. Con un token personal, tienes el mismo acceso que en navegador web.
Si usas OAuth2, puedes elegir entre autorizar el acceso a entornos de trabajo específicos la primera vez que te autenticas o cuando vuelvas a autenticarte más adelante.
Captura de pantalla de una persona seleccionando los entornos de trabajo que va a autorizar con OAuth2.