# Tokens de acceso personal

## Por qué es importante

Los **tokens de acceso personal** permiten que sus scripts, integraciones y herramientas se autentiquen en la API sin usar su contraseña. Cada token solo lleva los permisos (**ámbitos**) que le otorgue y puede revocarse en cualquier momento.

Como un token es limitado y revocable, es más seguro que compartir su contraseña: usted decide exactamente qué puede hacer cada integración y puede cortar el acceso al instante sin cambiar sus propias credenciales.

<Callout type="info" title="Función en beta">
Los tokens de acceso personal están actualmente en **beta**. Las pantallas y las opciones pueden cambiar.
</Callout>

## Para qué sirve un token

Un token de acceso personal es lo que permite que *algo distinto de la aplicación web* actúe sobre su cuenta a través de la API. Usos habituales:

- **Conectar su propia aplicación o sitio web** - sincronizar los nuevos registros en una lista de contactos, o activar un correo electrónico cuando alguien completa una acción.
- **Automatizar tareas rutinarias** - ejecutar un script programado que importe contactos, actualice segmentos o exporte informes.
- **Enviar correos electrónicos transaccionales a través de la API** - usar la Email API desde su back end para recibos, restablecimientos de contraseña y notificaciones.
- **Conectar herramientas no-code y de integración** - autenticar un flujo de trabajo en una herramienta que pide un token de API.
- **Crear y probar integraciones** - los desarrolladores usan un token limitado durante el desarrollo y luego uno más restringido en producción.

En resumen: siempre que una herramienta le pida un token o una clave de API para conectarse a su cuenta, un token de acceso personal es lo que usted crea y pega — en lugar de entregar su contraseña.

## Abrir los tokens de acceso personal

<Stepper>

1. En el menú de la izquierda, abra **Ajustes**.

2. Bajo el encabezado **Developer**, haga clic en **Tokens de acceso personal**.

</Stepper>

![El menú Ajustes con la sección Developer abierta, mostrando Tokens de acceso personal](/images/account-settings/personal-access-tokens-menu.png)

La página lista sus tokens e indica cuántos ha creado con respecto a su límite (por ejemplo, **1 / 25 tokens**).

## Crear un token

<Stepper>

1. Haga clic en **Crear token** en la parte superior derecha.

2. Escriba un **Nombre del token** que describa dónde se usará el token (por ejemplo, *Mi Integración*). Un nombre claro facilita distinguir los tokens más adelante.

3. Elija un **Vencimiento**: **Nunca**, **30 días**, **60 días**, **1 año** o **Personalizado**.

4. Conceda los permisos. Elija un preajuste en **Empezar desde una plantilla** — **Solo lectura (todo)**, **Acceso completo**, **Gestor de campañas**, **Gestor de contactos** o **Desarrollador** — o despliegue los grupos de ámbitos (**Audiencia**, **Supresiones**, **Campañas**, **Plantillas**, **Email API**, **Formularios**, **Entregabilidad**, **Webhooks**, **Análisis**, **Cuenta**) y marque exactamente lo que el token necesita.

5. Haga clic en **Crear**.

</Stepper>

![La ventana Crear token con el campo Nombre del token, las opciones de Vencimiento, las plantillas y los grupos de ámbitos](/images/account-settings/personal-access-tokens-create.png)

<Callout type="caution" title="Copie su token de inmediato">
Copie el token en cuanto se cree y guárdelo en un lugar seguro — trátelo como una contraseña. Nunca lo suba a un control de versiones ni lo comparta en texto plano. Si un token queda expuesto, revóquelo y cree uno nuevo.
</Callout>

## Entender los ámbitos

Los **ámbitos** definen lo que un token puede hacer. Conceda solo los ámbitos que una integración realmente necesita — así limita el daño si el token se filtra (principio de mínimo privilegio).

Los ámbitos se agrupan por área, y la fila de cada token resume a qué puede acceder (por ejemplo, **Audience · 20**, **Suppressions · 3**, **Campaigns · 7**). Los preajustes **Empezar desde una plantilla** aplican rápidamente un conjunto de ámbitos habitual:

- **Solo lectura (todo)** - solo lectura en todas las áreas, sin hacer cambios.
- **Acceso completo** - todos los ámbitos; úselo con moderación.
- **Gestor de campañas** - centrado en el trabajo de campañas.
- **Gestor de contactos** - centrado en audiencias y contactos.
- **Desarrollador** - un conjunto orientado a desarrolladores para crear integraciones.

## Gestionar sus tokens

La lista de tokens muestra para cada uno su **Nombre**, sus **Ámbitos**, su **Estado**, la fecha de creación (**Creado**) y la fecha de vencimiento (**Vence**). Use las pestañas para filtrar por estado: **Activo**, **Revocado**, **Expirado** o **Todos**.

Cada fila ofrece acciones para:

- **Ver** los detalles y los ámbitos del token.
- **Editar** el token (por ejemplo, renombrarlo o ajustar sus ámbitos).
- **Eliminar / revocar** el token, lo que lo invalida de inmediato.

<Callout type="tip" title="Rote y depure con regularidad">
Asigne un token distinto a cada integración, revise la lista de vez en cuando y revoque cualquier token que ya no reconozca o no use. Un token por integración le permite revocar uno solo sin romper los demás.
</Callout>

## Artículos relacionados

- [Su panel de cuenta: Client ID y uso](/es/docs/account-settings/finding-your-client-id) - Encuentre el número de cuenta que exigen algunas integraciones
- [Primeros pasos con la Email API](/es/docs/email-api/getting-started-with-the-email-api) - Autentíquese y envíe su primera solicitud a la API
- [Autenticación multifactor (MFA)](/es/docs/account-settings/multi-factor-authentication-mfa) - Añada una capa de seguridad a su cuenta
