Migrar de Resend a Postal

Registra el dominio en el panel y crea los registros de DNS que muestra. Puedes mantener el mismo dominio en Resend y en Postal a la vez: los registros son diferentes, porque Postal usa el selector postal en el DKIM.

• Postal comprueba los registros por sí sola durante hasta 72 horas y avisa por webhook (domain.updated)
• Si el dominio aún no tiene DMARC, los grandes proveedores se lo exigen a quien envía volumen: empieza con p=none y endurece después
• Crea una clave de API en Claves de API. Para sistemas que solo envían, usa una clave solo de envío, restringida al dominio

Los SDK oficiales de Resend funcionan apuntando a Postal. En Node.js, pasa baseUrl al crear el cliente o define RESEND_BASE_URL. El cuerpo del correo, la respuesta ({"id"}) y el formato de error (statusCode, name, message) siguen igual.

Con el SDK

- const resend = new Resend(process.env.RESEND_API_KEY);+ const resend = new Resend(process.env.POSTAL_API_KEY, { baseUrl: 'https://api.postal.so' });

O solo con el entorno

# Sin tocar el código que ya usa new Resend(clave)
RESEND_BASE_URL=https://api.postal.so
RESEND_API_KEY=ps_sua_chave

Por HTTP

- curl -X POST 'https://api.resend.com/emails' -H 'Authorization: Bearer re_...'+ curl -X POST 'https://api.postal.so/emails' -H 'Authorization: Bearer ps_...'

Por SMTP

- Servidor: smtp.resend.com- Usuario: resend- Contraseña: re_...+ Servidor: smtp.postal.so+ Usuario: postal (resend también se acepta)+ Contraseña: ps_...

Probado con el paquete resend 6.34 (Node.js): envío simple, programado, por lotes y con idempotencia, consulta, edición y cancelación, adjuntos, dominios, claves de API, webhooks y webhooks.verify. Otros SDK que permiten cambiar la URL base usan el mismo formato, pero no se han probado uno a uno: si encuentras una diferencia, avísanos por el formulario de contacto.

Antes de cambiar el tráfico, lleva la lista de supresión, para no escribir a quien ya pidió salir, y los contactos, si usas la audiencia. Recrea también las plantillas: las variables {{{VAR}}} son las mismas que en Resend.

• Lista de supresión: POST /suppressions/batch/add, con 100 direcciones por solicitud
• Contactos: importación por CSV, desde el panel o por la API
• Plantillas: crea y publica con el mismo alias y las mismas variables; los envíos usan siempre la última versión publicada

curl -X POST https://api.postal.so/suppressions/batch/add \
  -H "Authorization: Bearer $POSTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["[email protected]", "[email protected]"]}'

Los nombres de los eventos son los mismos (email.delivered, email.bounced…), con el formato {type, created_at, data}. Lo que cambia es el secreto: en Postal, cada endpoint tiene su signing_secret (whsec_…). La firma sigue el estándar Standard Webhooks, y resend.webhooks.verify acepta los encabezados webhook-* y svix-*.

• Crea el endpoint en Webhooks (panel o POST /webhooks) y elige los eventos
• Envía un evento de prueba desde el panel antes de cambiar el tráfico
• Son 8 intentos en unas 27 horas, siempre con el mismo webhook-id; el reenvío manual se hace desde el panel o con POST /webhooks/{id}/events/{event_id}/replay
• Otros lenguajes: consulta la verificación de la firma

import { Resend } from 'resend';

const resend = new Resend(process.env.POSTAL_API_KEY, { baseUrl: 'https://api.postal.so' });

// Lee el cuerpo crudo de la solicitud, sin reformatear el JSON
const event = resend.webhooks.verify({
  payload: rawBody,
  headers: {
    id: request.headers['webhook-id'],
    timestamp: request.headers['webhook-timestamp'],
    signature: request.headers['webhook-signature'],
  },
  webhookSecret: process.env.POSTAL_WEBHOOK_SECRET, // whsec_...
});

Cambia la URL base y la clave en el entorno de pruebas, envíate un correo electrónico a ti mismo y síguelo en Registros y en los webhooks. Las direcciones de prueba aceptan +rótulo, no consumen cuota, no afectan a la reputación y generan webhooks reales (dependen del plan). Después, haz el cambio en producción y deja Resend a mano unos días.

• ID diferentes. Los ID de correos y de webhooks de Resend no existen en Postal, y al revés tampoco. Guarda de qué proveedor salió cada correo y sigue recibiendo eventos de Resend para lo que salió por allí
• Marca el origen. Usa tags (por ejemplo, provider: postal) y una Idempotency-Key propia en cada envío
• Un proveedor a la vez en el mismo flujo. Las invitaciones, los restablecimientos de contraseña y los códigos deben salir por un solo camino. Vigila los rebotes los primeros días, porque el límite de reputación vale para todo el equipo
• Dirección que volvió a funcionar. Un rebote permanente pone la dirección en la lista de supresión; quítala con DELETE /suppressions/{id} o POST /suppressions/batch/remove