Do Postmark para a Postal, e o que não tem par

Adicione o domínio no painel (ou com POST /domains), crie na sua DNS os registros que a Postal mostra e peça a verificação. A Postal assina com DKIM no seletor postal e usa um subdomínio postal para o Return-Path, então confira que nenhum registro seu já usa esses nomes e mantenha os do Postmark até a virada terminar.

• O token do servidor, que só envia, corresponde a uma chave só de envio. Quem também gerencia templates, supressões e webhooks por API precisa de uma chave de acesso total.
• A chave pode ser restrita a um domínio, o que ajuda a separar sistemas. O token completo aparece uma única vez, na criação.
• Região: a Postal envia de São Paulo por padrão e deixa escolher us-east-1, us-east-2, eu-west-1 ou ap-northeast-1 em cada domínio.

Os campos mudam de nome e a chave muda de cabeçalho. Muda também o jeito de saber se deu certo: o Postmark responde com ErrorCode no corpo, e a Postal usa o status HTTP e um erro com statusCode, name e message. A resposta de sucesso é só {"id": "…"}. Com o cabeçalho Idempotency-Key, repetir uma requisição não duplica o envio.

- curl "https://api.postmarkapp.com/email" \-   -X POST \-   -H "Accept: application/json" \-   -H "Content-Type: application/json" \-   -H "X-Postmark-Server-Token: $POSTMARK_SERVER_TOKEN" \-   -d '{-     "From": "[email protected]",-     "To": "[email protected]",-     "Subject": "Seu pedido #10482 saiu para entrega",-     "HtmlBody": "<p>O pedido <b>#10482</b> está a caminho.</p>",-     "Tag": "envio",-     "MessageStream": "outbound"-   }'+ 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": "Seu pedido #10482 saiu para entrega",+     "html": "<p>O pedido <b>#10482</b> está a caminho.</p>",+     "tags": [{"name": "stream", "value": "transactional"}]+   }'

- const response = await fetch('https://api.postmarkapp.com/email', {-   method: 'POST',-   headers: {-     Accept: 'application/json',-     'Content-Type': 'application/json',-     'X-Postmark-Server-Token': process.env.POSTMARK_SERVER_TOKEN,-   },-   body: JSON.stringify({-     From: '[email protected]',-     To: '[email protected]',-     Subject: 'Seu pedido #10482 saiu para entrega',-     HtmlBody: '<p>O pedido <b>#10482</b> está a caminho.</p>',-     MessageStream: 'outbound',-   }),- });- const { MessageID, ErrorCode } = await response.json();+ const response = await fetch('https://api.postal.so/emails', {+   method: 'POST',+   headers: {+     Authorization: `Bearer ${process.env.POSTAL_API_KEY}`,+     'Content-Type': 'application/json',+     'Idempotency-Key': 'order-10482-shipped',+   },+   body: JSON.stringify({+     from: 'Aurora Cosméticos <[email protected]>',+     to: ['[email protected]'],+     subject: 'Seu pedido #10482 saiu para entrega',+     html: '<p>O pedido <b>#10482</b> está a caminho.</p>',+     tags: [{ name: 'stream', value: 'transactional' }],+   }),+ });+ if (!response.ok) { /* status HTTP e corpo { statusCode, name, message } */ }+ const { id } = await response.json();

Os templates do Postmark aceitam blocos e repetições, como {{#each person}}, e o modelo (TemplateModel) é um objeto que pode ter outros objetos dentro. Os da Postal só substituem variáveis, no formato {{{NOME}}}, com três chaves, e cada valor precisa ser texto ou número. Quando o seu template depende de blocos, mova a lógica para o código: escolha entre templates ou monte o HTML você mesmo e mande em html.

• Na Postal você edita um rascunho e publica; os envios usam sempre a última versão publicada, e as versões antigas podem ser restauradas.
• A Postal também tem layouts, para reaproveitar desenhos de e-mail. Não os trate como idênticos aos layouts do Postmark: recrie e teste.
• No HTML os valores são escapados. Uma variável sem valor e sem valor padrão (fallback_value) devolve erro 422.

- <p>Olá, {{name}}!</p>- <p>Seu pedido: {{order.id}}</p>+ <p>Olá, {{{NAME}}}!</p>+ <p>Seu pedido: {{{ORDER}}}</p>

- "TemplateAlias": "pedido-enviado",- "TemplateModel": { "name": "Ana", "order": { "id": 10482 } }+ "template": {+   "id": "pedido-enviado",+   "variables": { "NAME": "Ana", "ORDER": "10482" }+ }

No Postmark, um servidor tem streams: transacional (por padrão, outbound), de broadcasts e de entrada, até 10 no total, e as supressões são guardadas por stream. A Postal não tem esse objeto. Os três usos têm um caminho, mas nenhum é um campo no envio, e a separação de supressões não existe: a lista é única para o time.

• Para isolar a reputação, use domínios ou subdomínios diferentes (um para o transacional, outro para as campanhas) e uma chave restrita a cada domínio.
• A pausa por taxa alta de bounces ou reclamações vale para o time inteiro, não para um domínio ou uma tag. Veja os limites de reputação em Limites.
• Se o seu uso depende de streams separados com supressões independentes, converse com a gente antes de migrar.

Se algum sistema envia por SMTP, troque servidor, usuário e senha e tire os cabeçalhos X-PM-*. As mensagens passam pelas mesmas regras da API (domínio verificado, cotas, lista de supressão) e aparecem em E-mails e Logs.

- host: 'smtp.postmarkapp.com',- port: 587,- secure: false,- auth: { user: process.env.POSTMARK_SERVER_TOKEN, pass: process.env.POSTMARK_SERVER_TOKEN },+ host: 'smtp.postal.so',+ port: 465,+ secure: true,+ auth: { user: 'postal', pass: process.env.POSTAL_API_KEY },

Crie o endpoint na Postal (POST /webhooks, com URL HTTPS e a lista de eventos) e guarde o signing_secret. A mudança de fundo é a segurança: o Postmark não assina as entregas, e a Postal assina todas. Calcule a assinatura sobre o corpo exatamente como chegou, sem ler e reescrever o JSON.

• O webhook-id é o mesmo em todas as tentativas: guarde os já processados para descartar duplicatas.
• Responda 2xx logo e processe depois, numa fila.
• Para testar sem enviar de verdade, mande e-mails para os endereços de teste ou use "Enviar evento de teste" no painel.

- if (req.body.RecordType === 'Bounce') {-   // req.body.Email, req.body.MessageID- }+ const event = verifyWebhook(req.body, req.headers, process.env.POSTAL_WEBHOOK_SECRET);+ if (event.type === 'email.bounced') {+   // event.data.to, event.data.email_id+ }

{
  "type": "email.bounced",
  "created_at": "2026-10-24T13:02:15.004Z",
  "data": {
    "email_id": "019a1b2c-4d5e-7f60-8a9b-0c1d2e3f4a5b",
    "to": ["[email protected]"],
    "subject": "Seu pedido #10482 saiu para entrega",
    "tags": { "stream": "transactional" },
    "bounce": {
      "type": "Permanent",
      "subType": "General",
      "message": "smtp; 550 5.1.1 user unknown"
    }
  }
}

Faça isso antes do primeiro envio real, para não escrever a quem já pediu para sair nem repetir bounces. A Postal pausa os envios do time se os bounces permanentes passam do limite do nível da reputação da conta (3% numa conta nova) ou as reclamações passam de 0,3%; por isso a lista limpa importa. O exemplo lê a lista de um stream no Postmark e a envia à Postal em blocos de 100. Repita para cada stream e use uma chave de acesso total.

- const base = 'https://api.postmarkapp.com/message-streams';- const dump = await fetch(`${base}/${stream}/suppressions/dump`, {-   headers: {-     Accept: 'application/json',-     'X-Postmark-Server-Token': process.env.POSTMARK_SERVER_TOKEN,-   },- }).then((r) => r.json());- const emails = dump.Suppressions.map((s) => s.EmailAddress);+ for (let i = 0; i < emails.length; i += 100) {+   await fetch('https://api.postal.so/suppressions/batch/add', {+     method: 'POST',+     headers: {+       Authorization: `Bearer ${process.env.POSTAL_API_KEY}`,+       'Content-Type': 'application/json',+     },+     body: JSON.stringify({ emails: emails.slice(i, i + 100) }),+   });+ }

Os IDs são diferentes: o MessageID de um e-mail do Postmark não existe na Postal. Durante a virada, guarde de qual provedor veio cada e-mail e continue recebendo os webhooks do Postmark para o que saiu por lá. Mande cada fluxo por um provedor só, para não duplicar nem pausar tudo por causa de e-mails errados.