E-mail transacional que chega, feito para quem desenvolve.

cURL

curl -X POST https://api.postal.so/emails \
  -H "Authorization: Bearer $POSTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-10482" \
  -d '{
    "from": "Loja Exemplo <[email protected]>",
    "to": ["[email protected]"],
    "subject": "Seu pedido saiu para entrega",
    "html": "<p>O pedido <b>#10482</b> está a caminho.</p>"
  }'

Node.js

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',
  },
  body: JSON.stringify({
    from: 'Loja Exemplo <[email protected]>',
    to: ['[email protected]'],
    subject: 'Seu pedido saiu para entrega',
    html: '<p>O pedido <b>#10482</b> está a caminho.</p>',
  }),
});

const { id } = await response.json();

Python

import os
import requests

response = requests.post(
    "https://api.postal.so/emails",
    headers={
        "Authorization": f"Bearer {os.environ['POSTAL_API_KEY']}",
        "Idempotency-Key": "order-10482",
    },
    json={
        "from": "Loja Exemplo <[email protected]>",
        "to": ["[email protected]"],
        "subject": "Seu pedido saiu para entrega",
        "html": "<p>O pedido <b>#10482</b> está a caminho.</p>",
    },
    timeout=10,
)

email_id = response.json()["id"]

PHP (Laravel)

use Illuminate\Support\Facades\Http;

$response = Http::withToken(config('services.postal.key'))
    ->withHeaders(['Idempotency-Key' => 'order-10482'])
    ->post('https://api.postal.so/emails', [
        'from' => 'Loja Exemplo <[email protected]>',
        'to' => ['[email protected]'],
        'subject' => 'Seu pedido saiu para entrega',
        'html' => view('emails.order-shipped')->render(),
    ]);

$id = $response->json('id');

SMTP

# Funciona com qualquer biblioteca de SMTP. Exemplo de .env (Laravel):
MAIL_MAILER=smtp
MAIL_HOST=smtp.postal.so
MAIL_PORT=587   # STARTTLS, ou 465 com TLS direto
MAIL_USERNAME=postal
MAIL_PASSWORD=ps_sua_chave_de_api
MAIL_FROM_ADDRESS=[email protected]