Envía correos desde tu código, como ya lo haces.

Usa una clave por sistema y por entorno. La tienda en línea, WordPress o el ERP solo necesitan enviar: dales una clave solo de envío, ligada al dominio correcto.

• Si una clave solo de envío se filtra, solo puede enviar y ver lo que ella misma envió
• La clave aparece una única vez, al crearla
• Las claves solo de envío y ligadas a un dominio dependen del plan

Todos los caminos pasan por las mismas reglas: dominio verificado, cuotas, lista de supresión y los mismos eventos. Elige por dónde enviar.

curl -X POST https://api.postal.so/emails \
  -H "Authorization: Bearer $POSTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Aurora Cosméticos <[email protected]>",
    "to": ["[email protected]"],
    "subject": "Tu pedido #10482 salió para la entrega",
    "html": "<p>El pedido <b>#10482</b> está en camino.</p>"
  }'

import { Postal } from 'postal-so';

const postal = new Postal(); // lee POSTAL_API_KEY

const { id } = await postal.emails.send(
  {
    from: 'Aurora Cosméticos <[email protected]>',
    to: '[email protected]',
    subject: 'Tu pedido #10482 salió para la entrega',
    html: '<p>El pedido <b>#10482</b> está en camino.</p>',
  },
  { idempotencyKey: 'order-10482-shipped' },
);

use Postal\Client;

$postal = new Client(); // lee POSTAL_API_KEY

$result = $postal->emails->send([
    'from' => 'Aurora Cosméticos <[email protected]>',
    'to' => '[email protected]',
    'subject' => 'Tu pedido #10482 salió para la entrega',
    'html' => '<p>El pedido <b>#10482</b> está en camino.</p>',
], 'order-10482-shipped'); // clave de idempotencia

echo $result['id'];

Servidor   smtp.postal.so
Puerto     465 (TLS directo) o 587 (STARTTLS)
Usuario    postal
Contraseña una clave de API (ps_...)

# Laravel, en .env
MAIL_MAILER=smtp
MAIL_SCHEME=smtps
MAIL_HOST=smtp.postal.so
MAIL_PORT=465
MAIL_USERNAME=postal
MAIL_PASSWORD=ps_sua_chave

Cada petición hecha con una clave de API y cada mensaje enviado por SMTP aparece en Registros, con el cuerpo enviado y la respuesta. Los registros se guardan durante 30 días.

Recibe cada evento de correo en tu servidor, con firma en el estándar Standard Webhooks, hasta 8 intentos y reenvío manual. El SDK comprueba la firma en una línea.

• 30 tipos de evento, de correos a contactos y buzones de entrada
• El mismo webhook-id en todos los intentos, para descartar duplicados
• Evento de prueba y direcciones de prueba, como [email protected]

import express from 'express';
import {
  verifyWebhook,
  PostalWebhookVerificationError,
} from 'postal-so';

const app = express();

// El cuerpo debe llegar crudo (Buffer)
app.post(
  '/webhooks/postal',
  express.raw({ type: 'application/json' }),
  (req, res) => {
    try {
      const event = verifyWebhook(
        req.body,
        req.headers,
        process.env.POSTAL_WEBHOOK_SECRET,
      );
      if (event.type === 'email.bounced') {
        // descarta la dirección
      }
      res.sendStatus(200);
    } catch (error) {
      if (error instanceof
          PostalWebhookVerificationError) {
        return res.sendStatus(400);
      }
      throw error;
    }
  },
);

Ver la página de webhooks

Las direcciones de prueba generan eventos y webhooks reales, no usan la cuota y no afectan la reputación. Dependen del plan. La CLI ayuda a probar desde la terminal, con salida JSON para scripts.

npm install --global postal-so
postal login
postal emails send \
  --from [email protected] \
  --to [email protected] \
  --subject "Teste" --text "Funcionou"

La API de Postal usa las mismas funciones, nombres de campos y formatos de respuesta, así que la migración suele consistir en cambiar la URL base y la clave. El SDK de Resend sigue funcionando si apuntas la URL base a Postal.

• Probado con el paquete resend 6.34 para Node.js
• Qué cambia: el secreto y las reglas de firma de los webhooks, los límites y las cuotas

- curl -X POST https://api.resend.com/emails \-   -H "Authorization: Bearer re_..."- - # ou, com o SDK da Resend, no .env- RESEND_BASE_URL=https://api.resend.com+ curl -X POST https://api.postal.so/emails \+   -H "Authorization: Bearer ps_..."+ + # ou, com o SDK da Resend, no .env+ RESEND_BASE_URL=https://api.postal.so

Leer la guía de migración

El encabezado OTP-Token lleva el código y el sitio de origen. Todavía es un borrador en la IETF y no todos los clientes de correo lo leen; quien no lo conoce, lo ignora.

From: Aurora Cosméticos <[email protected]>
Subject: Tu código de acceso
OTP-Token: "123456"; origin="https://app.exemplo.com.br"