# Simplificamos los estados de los emails

> Hemos sustituido los antiguos estados de email por un conjunto más claro y coherente. Te explicamos qué ha cambiado y cómo se corresponden los nuevos estados con los anteriores.

2026-02-25 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Los estados de email son una de las partes más importantes de la API: te indican exactamente en qué punto de su ciclo de vida se encuentra un email. Con el tiempo, nuestro conjunto original de estados creció de forma orgánica y se volvió confuso: ¿cuál es la diferencia entre `error` y `softfail`? ¿Es `held` lo mismo que `pending`? Decidimos poner orden.

## Los nuevos estados

Ahora tenemos **12 estados claros**, cada uno con su propio significado y color:

| Estado | Color | Descripción |
| --- | --- | --- |
| **accepted** | 🟡 | Aceptado para su entrega |
| **scheduled** | 🟡 | Programado para entregarse más adelante |
| **delivered** | 🟢 | Entregado al servidor de correo del destinatario |
| **bounced** | 🔴 | Falló de forma permanente (rebote duro) |
| **attempted** | 🟠 | Se intentó la entrega, pero falló temporalmente |
| **failed** | 🔴 | No se pudo entregar por un error concreto |
| **rejected** | 🔴 | Aceptado inicialmente y luego rechazado |
| **loaded** | 🔵 | Se cargó el contenido del email (seguimiento de aperturas) |
| **clicked** | 🟣 | Se hizo clic en un enlace del email |
| **suppressed** | ⚪ | El destinatario está en la lista de direcciones bloqueadas |
| **received** | 🟢 | Se aceptó un email entrante |
| **complained** | 🔴 | Se registró una queja de spam |

## Qué ha cambiado respecto a los estados anteriores

Los estados anteriores quedan obsoletos. Así se corresponden con los nuevos:

| Estado anterior (obsoleto) | Estado nuevo |
| --- | --- |
| `pending` | `accepted` o `scheduled` |
| `sent` | `delivered` |
| `held` | _(eliminado)_ |
| `hold_cancelled` | _(eliminado)_ |
| `softfail` | `attempted` |
| `hardfail` | `bounced` |
| `opened` | `loaded` |
| `error` | `failed` |
| `delayed` | _(eliminado)_ |
| `processed` | _(eliminado)_ |

Los estados renombrados son más descriptivos: `loaded` deja claro que registramos la carga del contenido del email (no necesariamente que una persona lo abra), `attempted` es menos ambiguo que `softfail` y `bounced` lo entiende todo el mundo.

## Compatibilidad con versiones anteriores

Hemos migrado todos los emails existentes y sus entregas a los nuevos estados, así que no verás ningún nombre de estado antiguo en los registros de emails ni de entregas, independientemente de cuándo se crearan.

El único lugar donde aún pueden aparecer los nombres de estado antiguos es en los **eventos ya generados y las peticiones de webhook** enviadas antes de este cambio. Esos payloads históricos son inmutables y conservarán los valores de estado originales con los que se crearon.

Si filtras o comparas valores de estado en tu código, actualiza tus integraciones para que usen los nuevos nombres.

---

Source: https://emailit.com/es/blog/simplificando-estados-de-email/
