Ir a contenido principal
Nota: Este contenido se tradujo a través de un software y es posible que no haya sido revisado. La versión en inglés se considera, por tanto, la versión oficial y es posible que haya sido actualizada. Para acceder a la versión en inglés, haz clic aquí.
Integrations

¿Cómo puedo acceder a mi clave API de HubSpot?

Última actualización: julio 23, 2021

Requisitos

Todos los productos y planes

Con la clave de API de HubSpot, los desarrolladores pueden crear aplicaciones personalizadas con las API de HubSpot. Cada clave es específica de una cuenta de HubSpot, no de un usuario individual, y solo se admite una clave por vez.

Acceder a tu clave API

Debes tener permisos de superadministrador para acceder a la clave de API de tu cuenta. 

  • En tu cuenta de HubSpot, haz clic en el símbolo de configuración settings, situado en la barra de navegación principal.
  • En el menú de la barra lateral izquierda, navega a Integraciones > Clave API.
    • Si nunca se generó una clave para tu cuenta, haz clic en Generar clave API.
    • Si ya generaste una clave API, haz clic en Mostrar para mostrar tu clave.

show-API-key

  • Con la clave que se muestra, haz clic en Copiar para copiar la clave. Luego, puedes pegar la clave para proporcionarla a los desarrolladores o usarla en las aplicaciones.

Rota tu clave API

Ofrecer tu clave de API a un desarrollador le dará acceso completo para hacer cambios en tu cuenta a través de la API de HubSpot, lo que incluye leer correos electrónicos registrados de cuentas de correo electrónico conectadas y otros datos de terceros.

Para tener más seguridad, considera rotar tu clave de API de HubSpot cada seis meses. Rotar tu clave API de HubSpot requiere desactivar la clave API existente y generar una nueva. HubSpot mostrará la edad de la clave API y recomendará cuándo deberías rotar tu clave API.

Se enviarán recordatorios para rotar la clave API a Súper Administradores y usuarios que crearon o rotaron la clave API en las siguientes frecuencias y tipos de notificaciones:

  • Cuando la clave API cumple cinco meses de antigüedad, se envían notificaciones de correo electrónico.
  • Cuando la clave API cumple seis meses de antigüedad, se envían notificaciones en la barra lateral.
  • Cuando la clave API no se haya rotado en seis meses, tanto las notificaciones de correo como la barra lateral se enviarán cada 6 meses.

Si bien esto puede crear tiempo de inactividad y requerir esfuerzo, agrega una capa de seguridad al evitar que aplicaciones maliciosas accedan a tu información de HubSpot con tu clave de API actual.

Para rotar tu clave de API de HubSpot:

  • En tu cuenta de HubSpot, haz clic en el ícono de configuración en la barra de navegación principal.
  • En el menú de la barra lateral izquierda, navega hasta Integraciones > Clave de API.
  • Haz clic en el menú desplegable Acciones, y luego selecciona Rotar clave.
  •  Haz clic en Rotar y caducar esta clave ahora. Selecciona la casilla de comprobación reCAPTCHA. Tu clave actual se desactivará y se creará una nueva clave de API.
  •  Haz clic en Copiar y reemplaza la clave de API desactivada utilizada por tus aplicaciones con esta nueva clave de API.

Cualquier llamada de API que use esta clave de API de HubSpot desactivada ahora fallará y cualquier aplicación que utilice esta clave ya no podrá acceder a tu información. 

Rotar tu clave de API no afectará tu conexión con la integración de Salesforce. Sin embargo, si tienes una integración personalizada instalada, deberás actualizar tu clave API después de que la rotes.

Nota: Las aplicaciones conectadas instaladas a través del mercado de apps no se verán afectadas cuando rotes tu clave de API.

Desactiva tu clave de API

Desactivar tu clave de API no creará una nueva clave. Las llamadas de API que usen la clave de API de HubSpot desactivada fallarán, y cualquier aplicación que utilice esta clave ya no podrá acceder a tu información.

Para desactivar tu clave de API:
  • En tu cuenta de HubSpot, haz clic en el símbolo de configuración settings, situado en la barra de navegación principal.
  • En el menú de la barra lateral izquierda, navega hasta Integraciones > Clave de API.
  • Haz clic en el menú desplegable Acciones.
  • Haz clic en Desactivar clave, y haz clic en Desactivar esta clave ahora. Selecciona la casilla de comprobación reCAPTCHA. 

Ve tu registro de auditoría de API

Puedes ver un registro fechado de usuarios que han visto, creado o desactivado la clave API de la cuenta en la sección Registro de auditoría

  • En tu cuenta de HubSpot, haz clic en el símbolo de configuración settings, situado en la barra de navegación principal.
  • En el menú de la barra lateral izquierda, navega hasta Integraciones > Clave de API.
  • Haz clic en la pestaña Registro de auditoría.
  • app-audit-log

Ver tu registro de llamada de clave API

Para ayudarte a depurar una de tus integraciones o para asegurarte de cumplir con las pautas de uso de la API de HubSpot, puedes ver un registro de las llamadas de tu clave de API de los 7 días anteriores. 

  • En tu cuenta de HubSpot, haz clic en el símbolo de configuración settings, situado en la barra de navegación principal.
  • En el menú de la barra lateral izquierda, navega hasta Integraciones > Clave de API.
  • En la pestaña Registro de llamadas, ve toda la actividad de los últimos 7 días.
call-log-api