Enviar un email transaccional
POST /notify/email envía un mensaje individual desde su propio dominio y le devuelve un task_id mientras el correo sale realmente de la cola. Está pensado para el instante en que un restablecimiento de contraseña, una confirmación de pedido o un código de acceso necesitan llegar a una bandeja de entrada en segundos, no para campañas masivas.
Pensado para el mensaje que no puede esperar
El correo de aplicación se divide en dos tareas muy distintas: los boletines masivos, que toleran retraso, y los mensajes transaccionales —restablecimientos de contraseña, recibos, códigos de verificación— que alguien está esperando ver aparecer en su bandeja. Este endpoint atiende solo la segunda tarea. Omite por completo la gestión de listas, las páginas de baja y la programación de campañas, así que la ruta de la petición se mantiene corta y la entrega, rápida.
Qué hace realmente la llamada
Envía el destinatario, el asunto, un cuerpo en texto plano o HTML y la dirección de origen sobre su dominio verificado; la API valida el payload, encola el envío y devuelve de inmediato un task_id. El intento de entrega real ocurre poco después en nuestra red global, y el resultado le llega mediante un webhook firmado (recomendado para cualquier proceso desatendido) o un enlace firmado válido por 24 horas. Nada del proceso es síncrono, y es justamente por eso que aguanta ráfagas de tráfico sin tambalearse.
Autenticación de dominio, no una reputación prestada
Como el envío sale desde su propio dominio, el correo llega con su nombre en la bandeja, no con un remitente genérico compartido con desconocidos. Ese detalle es lo que separa una API transaccional confiable de una herramienta de marketing disfrazada de endpoint REST: la reputación de envío de su dominio es tuya para construirla, cuidarla o repararla, sin arrastrar el historial de abuso de otro.
Los eventos de entrega cierran el ciclo
Enviar es solo la mitad de la historia: el payload del webhook también informa qué pasó después del envío —aceptado, entregado, rebotado o fallido—. Ese evento es lo que le permite a su sistema reintentar con criterio, marcar una dirección inválida o simplemente dar por confirmado un pedido cuando el correo pasa el servidor del destinatario, en vez de adivinar por el silencio.
Su lugar dentro de un flujo automatizado
Una tarea fallida nunca se cobra —ocurren tres reintentos automáticos antes de que vea un error claro—, así que puede conectar este endpoint directo a un flujo de pago, un formulario de registro o una alerta interna sin envolverlo primero en su propia lógica de reintentos. Es una llamada dentro de un pipeline, no una plataforma que hay que configurar.
Qué puede hacer con ella
Enlaces para restablecer contraseña
Un usuario pide un restablecimiento; su backend llama al endpoint en el instante en que se genera el token, y el enlace llega antes de que termine la redirección de la página.
Confirmaciones de pedido
En cuanto se acredita un pago, sale una confirmación con los detalles del pedido desde su propio dominio, y el evento de entrega le confirma que realmente llegó.
Códigos de acceso de un solo uso
Un inicio de sesión con enlace mágico o código envía el mensaje en el momento en que se solicita, manteniendo todo el flujo de autenticación en pocos segundos.
Alertas internas de operación
Un proceso en segundo plano que detecta un pago fallido o un faltante de inventario envía el correo directo a la bandeja del equipo de guardia, sin necesidad de un panel.
Preguntas frecuentes
¿Es gratis de usar?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuánto cuesta?
$0.002 por solicitud más $0.0035 por correo enviado. Una tarea fallida nunca se cobra.
¿Puedo enviar desde mi propio dominio?
Sí, ese es el propósito central del endpoint: los mensajes se envían desde un dominio que verificó usted, no desde una dirección compartida.
¿Cómo recibo el resultado, de forma síncrona o asíncrona?
La llamada es asíncrona: recibe un task_id de inmediato y el resultado llega por un webhook firmado o un enlace firmado válido por 24 horas.
¿Qué eventos de entrega reporta?
Los estados aceptado, entregado, rebotado y fallido se reportan por el webhook para que reaccione según lo que realmente ocurrió tras el envío.
¿Qué pasa si el envío falla?
El sistema reintenta automáticamente hasta tres veces; solo después devuelve un error claro, y nunca se cobra una tarea fallida.
¿Puedo enviar HTML y texto plano juntos?
Sí, el payload acepta un cuerpo en HTML junto con una versión de respaldo en texto plano dentro de la misma solicitud.
¿En qué se diferencia de una herramienta de envío masivo?
No tiene gestión de listas, ni flujos de baja, ni programación de campañas: está construido para mensajes transaccionales individuales y urgentes, no para envíos de marketing.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/notify/email \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/notify/email", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/notify/email",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/notify/email", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/email", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "notify.email",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |