¿Quieres crear una app que se integre con ClickUp? ¡Dale a tus usuarios la posibilidad de iniciar sesión con OAuth 2.0!

No dejes de revisar también nuestra documentación de la API.

Lo que necesitarás

• La API de ClickUp está disponible en todos los planes de ClickUp.
• Los propietarios o administradores del entorno de trabajo pueden gestionar la configuración de integraciones y crear apps OAuth en el entorno de trabajo.
• Los miembros y miembros con acceso limitado que tengan permisos de edición completa pueden usar tokens personales de la API.
• Los miembros con acceso limitado y permisos de solo lectura no pueden acceder ni gestionar la API.

Flujo de OAuth 2

Si quieres desarrollar una aplicación que otras personas puedan usar, debes utilizar un flujo de autenticación OAuth2.

Con OAuth 2, cada persona que usa tu app recibe un token individual. Cada usuario solo puede acceder al contenido disponible en su cuenta de usuario de ClickUp.

Si no conoces OAuth2, Digital Ocean tiene una excelente guía para que puedas empezar. También te recomendamos visitar el sitio web de OAuth para más detalles.

Crear una app

El primer paso para usar OAuth 2 es crear una app en tu entorno de trabajo. Debes ser propietario o administrador del entorno de trabajo para gestionar la configuración de integraciones.

Para crear una app en tu entorno de trabajo:

1. En la esquina superior izquierda, haz clic en el avatar de tu entorno de trabajo.
2. Selecciona Configuración.
3. En la barra lateral de Toda la configuración, selecciona API de ClickUp.
4. En la esquina superior derecha de la página de configuración de la API de ClickUp, haz clic en Crear una app.

   

5. Ingresa el nombre de tu app y una o varias URL de redireccionamiento. Si no sabes qué usar como URL de redireccionamiento, consulta la guía de URL de redireccionamiento en el sitio web de OAuth.
6. Haz clic en Crear app.
7. En la siguiente pantalla, verás que se generaron un ID de cliente y un Secreto de cliente.
8. Usa el ID de cliente y el Secreto de cliente en tu app para crear un flujo de autenticación OAuth 2.

Actualizar tus URL de redireccionamiento

Si tienes una nueva URL de redireccionamiento, puedes actualizar esta configuración en tu entorno de trabajo de ClickUp cuando quieras:

1. En la esquina superior izquierda, haz clic en el avatar de tu entorno de trabajo.
2. Selecciona Configuración.
3. En la barra lateral de Toda la configuración, selecciona API de ClickUp.
4. Haz clic en una app existente para expandir sus detalles.
5. Actualiza la URL de redireccionamiento.
6. Haz clic en Guardar.

Ver o regenerar tu secreto de cliente

Para regenerar tu secreto de cliente:

1. En la esquina superior izquierda, haz clic en el avatar de tu entorno de trabajo.
2. Selecciona Configuración.
3. En la barra lateral de Toda la configuración, selecciona API de ClickUp.
4. Haz clic en una app existente para expandir sus detalles.
5. Haz clic en Mostrar para ver tu secreto de cliente actual.
6. Haz clic en Regenerar para crear un nuevo secreto de cliente.
7. Actualiza tu app para usar el nuevo secreto de cliente.

Tipos de tokens de autorización

Los tokens te permiten hacer llamadas a la API e integrarte con otras aplicaciones. También puedes usar apps como Make para crear integraciones sin escribir código. Los tokens son específicos de tu cuenta de usuario de ClickUp.

Cualquier persona con una cuenta de ClickUp puede generar un token personal. Los tokens personales permiten acceder a todos los entornos de trabajo que tu cuenta haya creado o a los que te hayas unido. Tu token personal te da el mismo acceso que tienes a través de un navegador web.

Si usas OAuth2, puedes elegir autorizar el acceso a entornos de trabajo específicos al autenticarte por primera vez o al volver a autenticarte más adelante.