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

Consulta también nuestra documentación de la API.

Qué necesitarás

• La API de ClickUp está disponible en todos los planes de ClickUp.
• Los propietarios o administradores del Entorno de trabajo pueden gestionar los ajustes de integración y crear aplicaciones OAuth en el Entorno de trabajo.
• Los miembros y miembros con acceso limitado que tengan permisos de edición completos 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 use tu aplicación recibe un token individual. Cada usuario solo puede acceder al contenido disponible en su cuenta personal de usuario de ClickUp.

Si no estás familiarizado con OAuth2, Digital Ocean ha elaborado una guía estupenda para empezar. También te recomendamos consultar el sitio web de OAuth para obtener más información.

Crear una aplicación

El primer paso para usar OAuth 2 es crear una aplicación en tu Entorno de trabajo. Debes ser propietario o administrador del Entorno de trabajo para gestionar los ajustes de integración.

Para crear una aplicación en tu Entorno de trabajo:

1. En la esquina superior izquierda, haz clic en el avatar de tu Entorno de trabajo.
2. Selecciona Ajustes.
3. En la barra lateral Todos los ajustes, selecciona API de ClickUp.
4. En la esquina superior derecha de la página de ajustes de la API de ClickUp, haz clic en Crear una aplicación.

   

5. Escribe el nombre de tu aplicación y una o varias URL de redireccionamiento. Si no sabes qué URL de redireccionamiento utilizar, consulta la guía de URL de redireccionamiento 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 de cliente en tu aplicación para crear un flujo de autenticación OAuth 2.

Actualizar tus URL de redireccionamiento

Si tienes una nueva URL de redireccionamiento, puedes actualizar estos ajustes en tu Entorno de trabajo de ClickUp en cualquier momento:

1. En la esquina superior izquierda, haz clic en el avatar de tu Entorno de trabajo.
2. Selecciona Ajustes.
3. En la barra lateral Todos los ajustes, selecciona API de ClickUp.
4. Haz clic en una aplicación existente para ver 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 Ajustes.
3. En la barra lateral Todos los ajustes, selecciona API de ClickUp.
4. Haz clic en una aplicación existente para ver 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 aplicación para que use el nuevo Secreto de cliente.

Tipos de tokens de autorización

Los tokens te permiten realizar llamadas a la API e integrarte con otras aplicaciones. También puedes usar aplicaciones como Make para crear integraciones sin necesidad de 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 se haya unido. Tu token personal te otorga 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 cuando te autentiques por primera vez o cuando vuelvas a autenticarte más adelante.