API de email

La API de email envía email desde tu aplicación por HTTPS en lugar de por una conexión SMTP. Úsala para el correo transaccional, como confirmaciones de registro, restablecimientos de contraseña, recibos y avisos, sobre todo cuando quieras plantillas, programación, reintentos idempotentes y un ID distinto para cada destinatario.

Cómo funciona

1. Tu aplicación llama a POST /emails con una dirección From de un dominio de envíoDominio de envíoUn dominio de tu propiedad que verificas con registros DNS para que Emailit pueda enviar correo desde él con SPF, DKIM y un return-path personalizado. verificado, los destinatarios y el contenido o una plantilla.
2. Emailit valida la petición, cobra 1 crédito por destinatario y crea un email por destinatario, cada uno con su propio ID em_.
3. La respuesta llega al momento con el estado accepted, o scheduled si has indicado una hora de envío. La entrega se hace en segundo plano.
4. Emailit firma el mensaje con DKIM para tu dominio, ejecuta las comprobaciones de spam y lo entrega. Los fallos temporales se reintentan durante unas 21 horas.
5. Cada cambio de estado aparece en Email API›Emails y se envía a tus webhooks.

URL base y autenticación

Una clave Full Access puede llamar a todos los endpoints. Una clave Sending Only puede enviar, reprogramar, cancelar, reintentar y reenviar email, y puedes limitarla a un solo dominio de envío. Para más detalles, consulta Autenticación.

Enviar un email

curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up, Ada.</p>",
    "text": "Thanks for signing up, Ada."
  }'

import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

const email = await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up, Ada.</p>',
  text: 'Thanks for signing up, Ada.',
});

console.log(email.id);

import os
from emailit import EmailitClient

client = EmailitClient(os.environ["EMAILIT_API_KEY"])

email = client.emails.send({
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up, Ada.</p>",
    "text": "Thanks for signing up, Ada.",
})

$emailit = Emailit::client(getenv('EMAILIT_API_KEY'));

$email = $emailit->emails()->send([
    'from' => 'Acme <hello@acme.com>',
    'to' => 'ada@example.com',
    'subject' => 'Welcome to Acme',
    'html' => '<p>Thanks for signing up, Ada.</p>',
    'text' => 'Thanks for signing up, Ada.',
]);

Una petición correcta devuelve 200 con el email nuevo:

{
  "object": "email",
  "id": "em_33VtK8mRq1xZp7LwN4cY2bHsDfa",
  "token": "33VtK8m4XcPq2RwZ7nLb1YsTgHd",
  "message_id": "<33VtK8m4XcPq2RwZ7nLb1YsTgHd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Welcome to Acme",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418203Z",
  "tracking": { "loads": false, "clicks": false }
}

Los espacios de trabajo nuevos empiezan en modo sandbox y solo pueden enviar a las direcciones de email de cuenta de los miembros del espacio de trabajo. Solicita el acceso de producción antes de enviar a cualquier otra persona.

Qué puedes hacer

Límites

Los límites de velocidad cuentan destinatarios, así que una petición a 10 destinatarios consume 10 de tu cupo por segundo y diario. Los espacios de trabajo Pro y Business reciben aumentos automáticos según su salud de envío, y cualquier espacio de trabajo puede pedir más desde la tarjeta Sending Limits de la página de inicio del panel. Consulta Límites y Límites de velocidad.

Créditos

Cada destinatario cuesta 1 crédito, y cuentan todas las direcciones de to, cc y bcc. Si el espacio de trabajo no tiene créditos suficientes para todos los destinatarios, la petición falla con 402 y no se envía nada. Los reintentos y los reenvíos se cobran como envíos nuevos.

Para saber cómo se usan los créditos incluidos y los comprados, consulta Créditos.

Próximos pasos