Referencia
Registro de cambios de API de email
Cambios en API de email: nuevas funciones, mejoras y correcciones.
septiembre de 2026
Mejorado
Reintentar emails retenidos
API de emailRegistros de emails
El botón Retry de un email retenido ya funciona, y Reintentar un email acepta emails con el estado
held. Primero corrige el motivo por el que se retuvo el email, por ejemplo una puntuación de spam alta o la falta de créditos, y después reinténtalo.Un reintento crea un email nuevo con un ID nuevo y cuesta créditos como cualquier otro envío. Los emails con más de 30 días, o cuyo contenido se eliminó por la retención de datos, no se pueden reintentar. Consulta Reintentar y reenviar.
Modificado
Se elimina Reply-To cuando coincide con From
API de emailSMTP relayEntregabilidad
Emailit compara las direcciones de
Reply-ToyFromsin tener en cuenta los nombres visibles ni las mayúsculas y minúsculas. Cuando coinciden, eliminaReply-Toantes de firmar el mensaje. Las respuestas siguen llegando a la direcciónFrom.Cuando las direcciones son distintas,
Reply-Tose mantiene sin cambios. Consulta Cabeceras de email.Corregido
Coincidencia de dominios de envío y configuración de subdominios
Dominios de envíoAPI de emailSMTP relaySeguimiento de aperturas y clicsEmails entrantes
- La API y SMTP comparan el dominio de
Fromsin distinguir mayúsculas y minúsculas, así queada@Acme.comenvía desde el dominio verificadoacme.com. - Cambiar el subdominio de seguimiento o de entrada de un dominio en el panel, o con
tracking_keyeinbound_keyen Actualizar un dominio, ahora guarda el nuevo valor. Publica el registro DNS del nuevo nombre y verifícalo.
- La API y SMTP comparan el dominio de
Corregido
Correcciones de compatibilidad de la API v2
API RESTClaves de APIAPI de emailDominios de envío
- Las claves de API creadas antes de que las claves tuvieran el prefijo
secret_vuelven a aceptarse en/v2. - Obtener un email devuelve el objeto de email completo, incluidos
object,fromyto. - Las respuestas de dominios devuelven
track_loadsytrack_clickscomo0o1, tal como está documentado.
- Las claves de API creadas antes de que las claves tuvieran el prefijo
Modificado
Los emails se envían sin seguimiento hasta que se verifica el dominio de seguimiento
Seguimiento de aperturas y clicsAPI de email
Antes, una petición de envío con
trackingactivado fallaba con422cuando el dominio de envío no tenía un CNAME de seguimiento verificado. Ahora Emailit acepta el email y lo envía sin reescribir los enlaces ni añadir el píxel de apertura.Para hacer seguimiento de aperturas y clics, publica el registro CNAME de seguimiento de tu dominio y verifícalo. Consulta Dominio de seguimiento personalizado.
Modificado
Los emails muestran attempted mientras Emailit reintenta
Registros de emailsAPI de email
Los fallos temporales se registraban en la entrega, pero el email conservaba su estado anterior. Ahora el propio email pasa a
attemptedmientras Emailit reintenta, así que la lista de emails y la API muestran qué emails están retrasados.Los estados posteriores, como
delivered, y los estados finales no se sobrescriben. Consulta Estados de los emails.Nuevo
Redactar y cancelar emails desde el panel
Registros de emailsAPI de email
- Compose, en la página Emails o en Quick Actions del panel, envía un email puntual desde un dominio verificado, por ejemplo para probar tu configuración. En Advanced puedes atribuir el envío a una clave de API. Compose permite 3 emails por minuto y 10 por hora por espacio de trabajo. Consulta Compose.
- Cancel delivery saca de la cola un email aceptado, programado o con fallo temporal. La cancelación no está garantizada: un email que ya se está entregando al servidor del destinatario puede llegar a entregarse. Consulta Cancelar un email.
Nuevo
Reenviar un email
API de emailRegistros de emails
Selecciona Forward en la página de detalles de un email, o llama a Reenviar un email con una dirección
to. Por defecto, el destinatario recibe una copia simple. Activa las cabeceras reenviadas y añade un comentario si quieres dar contexto.Un reenvío es un email nuevo: cuesta créditos y cuenta para tus límites de envío. Puedes reenviar 3 emails por hora por espacio de trabajo. Consulta Reintentar y reenviar.
Modificado
Los espacios de trabajo en modo sandbox solo envían a sus miembros
Espacios de trabajoAPI de emailSMTP relayCampañas
La regla del modo sandbox se aplica ahora a la API, SMTP, Compose, los reintentos, las automatizaciones y las campañas. Enviar a cualquier otra persona devuelve
403con el códigounverified_workspace_recipienten la API y550en SMTP, y los envíos de campañas se bloquean. Los espacios de trabajo con acceso de producción no se ven afectados.Para levantar la restricción, verifica un dominio y solicita acceso de producción.
Modificado
Las claves de API solo de envío se limitan a los endpoints de envío
Antes, las claves solo de envío podían listar y obtener emails y llamar a algunos otros endpoints de lectura. Ahora se limitan a Enviar un email y a las acciones sobre un email existente: reprogramar, cancelar, reintentar y reenviar. Los demás endpoints rechazan las claves de envío.
Si tu integración también lee emails, dominios u otros recursos, usa una clave de acceso total para esas llamadas. Consulta Claves de API.
marzo de 2026
Nuevo
Listar emails y leer su contenido con la API
- Listar emails:
GET /v2/emails - Obtener el MIME en bruto:
GET /v2/emails/:id/raw - Obtener el cuerpo:
GET /v2/emails/:id/body - Obtener los metadatos:
GET /v2/emails/:id/meta - Listar adjuntos:
GET /v2/emails/:id/attachments
Estos endpoints necesitan una clave de acceso total. El contenido está disponible hasta que el periodo de retención de datos de tu plan lo elimina.
- Listar emails:
febrero de 2026
Modificado
Estados de email simplificados
Registros de emailsAPI de emailWebhooks
Estado anterior Estado nuevo pendingacceptedoscheduledsentdeliveredsoftfailattemptedhardfailbouncedopenedloadederrorfailedLos emails y las entregas existentes se migraron a los nuevos nombres. Los eventos y las peticiones de webhook creados antes del cambio conservan los valores con los que se enviaron. Consulta Estados de los emails para ver la lista actual.
Nuevo
Plantillas y la API de plantillas
Crea plantillas con el editor HTML, el editor de texto enriquecido o el editor de arrastrar y soltar Dragit. Las plantillas que comparten un alias son versiones de una misma plantilla, y al enviar por alias solo se usa la versión publicada.
Gestiona las plantillas con la API de plantillas y envía una pasando
templateyvariablesa Enviar un email. Consulta Plantillas.
enero de 2026
Nuevo
Botón Retry
Registros de emailsAPI de email
Retry duplica el email original, asigna un ID nuevo a la copia y la envía por el flujo normal. Se factura como cualquier email nuevo. Para reintentar desde el código, llama a Reintentar un email.
Nuevo
Endpoints de emails en la API v2
- Enviar un email: cada destinatario recibe su propio ID de email. Programa el envío con una fecha ISO 8601, una marca de tiempo Unix o lenguaje natural como «tomorrow at 9am», y evita duplicados con la cabecera
Idempotency-Key. - Obtener un email: estado, cabeceras, contenido, configuración de seguimiento y metadatos.
- Actualizar un email programado: cambia la hora de envío hasta 3 minutos antes de la hora prevista.
- Cancelar un email: detén un email programado o en cola.
Cada respuesta de envío incluye cabeceras
ratelimit-*. Consulta Límites de velocidad.- Enviar un email: cada destinatario recibe su propio ID de email. Programa el envío con una fecha ISO 8601, una marca de tiempo Unix o lenguaje natural como «tomorrow at 9am», y evita duplicados con la cabecera
octubre de 2025
Modificado
Límites de velocidad por segundo y diarios
Límites y retenciónAPI de emailSMTP relay
Las peticiones que superan el límite se rechazan en lugar de ponerse en cola, así que configura tu cliente para enviar como máximo 2 emails por segundo o para reintentar los envíos rechazados. El cambio se aplicó a los espacios de trabajo de forma gradual.
Consulta Límites de velocidad.