# Endpoints /emails de la API v2 ya disponibles

> Envía, consulta, actualiza y cancela emails de forma programática con los nuevos endpoints de email de la API v2.

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

¡Nos complace anunciar que los **endpoints de email ya están disponibles en la API v2**! Ahora puedes enviar emails, consultarlos, actualizar los programados y cancelar los pendientes, todo ello a través de nuestra potente API REST.

## Nuevos endpoints

### Enviar email

```
POST /v2/emails
```

Envía un email a uno o varios destinatarios. El endpoint de envío admite:

- **Varios destinatarios** — Envía a hasta 50 destinatarios (TO, CC y BCC combinados)
- **Plantillas** — Usa alias o ID de plantilla con sustitución de variables mediante la sintaxis `{{variable}}`
- **Adjuntos** — Incluye archivos mediante contenido en base64 o una URL
- **Programación** — Programa emails para enviarlos más adelante con ISO 8601, marcas de tiempo Unix o lenguaje natural en inglés, como «tomorrow at 9am»
- **Seguimiento** — Sobrescribe la configuración de seguimiento predeterminada del dominio para aperturas y clics
- **Metadatos** — Adjunta pares clave-valor personalizados que se almacenan y se devuelven con el email
- **Idempotencia** — Evita envíos duplicados con la cabecera `Idempotency-Key`

Al enviar a varias direcciones, cada destinatario recibe su propio ID de email único para un seguimiento individual.

### Obtener email

```
GET /v2/emails/{id}
```

Consulta información detallada sobre un email concreto, incluidos:

- Estado actual (pendiente, programado, enviado, entregado, rebotado, cancelado)
- Cabeceras y contenido sin procesar del email
- Configuración de seguimiento
- Metadatos personalizados
- Marcas de tiempo de creación y actualización

### Actualizar email programado

```
POST /v2/emails/{id}
```

Reprograma un email cuyo envío está previsto para más adelante. Puedes cambiar la hora programada siempre que falten al menos 3 minutos para el envío.

### Cancelar email

```
POST /v2/emails/{id}/cancel
```

Cancela un email programado o pendiente antes de que se envíe. En el caso de los emails programados, la cancelación debe solicitarse al menos 3 minutos antes de la hora de envío programada.

## Límites de peticiones

Cada respuesta incluye cabeceras de límite de peticiones para que puedas controlar tu uso:

- `ratelimit-limit` — Máximo de peticiones por segundo
- `ratelimit-remaining` — Peticiones restantes en el segundo actual
- `ratelimit-daily-limit` — Máximo de peticiones diarias
- `ratelimit-daily-remaining` — Peticiones diarias restantes

## Documentación

Ya está disponible la documentación completa, con ejemplos de código en Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET y cURL:

- [Enviar email](https://emailit.com/docs/api-reference/emails/send)
- [Obtener email](https://emailit.com/docs/api-reference/emails/get)
- [Actualizar email programado](https://emailit.com/docs/api-reference/emails/update)
- [Cancelar email](https://emailit.com/docs/api-reference/emails/cancel)

## Próximamente: API de plantillas

Estamos trabajando en la **API de plantillas**, que te permitirá crear, actualizar y gestionar plantillas de email de forma programática. ¡No te pierdas esta novedad!

## Aviso de retirada de la API v1

**Importante:** la API v1 está obsoleta y dejará de funcionar a finales de febrero de 2026. Si todavía usas la API v1, migra a la API v2 lo antes posible.

¿Necesitas ayuda con la migración? Consulta nuestra [documentación de la API v2](https://emailit.com/docs/api-reference) o ponte en contacto con nuestro equipo de soporte.

---

Source: https://emailit.com/es/blog/api-v2-emails-endpoints/
