---
updatedAt: 2025-11-05T19:56:14.000Z
agentTools:
  projectIndex: https://developer.alegra.com/llms.txt
---

# Autenticación

> 🚧 [¡Hay novedades importantes que requieren tu atención!](https://developer.alegra.com/changelog/nuevo-formato-de-id)

El API de Alegra utiliza Basic Access como método de autenticación. Todos los request que se realicen deben incluir el header Authorization.

El acceso al API se realiza utilizando el correo y el token otorgado al usuario registrado en Alegra.

## Obtener token de acceso

Debes seguir los siguientes pasos para obtener el token de acceso:

1. Ingresar a aplicación [Alegra](https://app.alegra.com).
2. Haz clic sobre el vínculo "Configuración" en la parte superior derecha de la pantalla de Alegra y haz clic en la sección "API - Integraciones con otros sistemas"
3. En la nueva pantalla puedes encontrar el correo con el cual debes acceder al API y el token. Si aún no cuentas con un token puedes generarlo también.

## ¿Cómo utilizar el token?

En el header *Authorization* se debe poner el correo y el token del usuario separado por dos puntos (:), todo en base64.

Por ejemplo, si el correo del usuario es <ejemploapi@alegra.com> y el token es tokenejemploapi12345 el header *Authorization* debe quedar así :

```
Authorization: Basic ZWplbXBsb2FwaUBhbGVncmEuY29tOnRva2VuZWplbXBsb2FwaTEyMzQ1
```

Donde `ZWplbXBsb2FwaUBhbGVncmEuY29tOnRva2VuZWplbXBsb2FwaTEyMzQ1` es base\_64('<ejemploapi@alegra.com>:tokenejemploapi12345')

## Errores en autenticación

Si el API encuentra algún inconveniente con la autenticación retorna un código 401 y el error encontrado.