{
  "event": "click",
  "email": "customer@example.com",
  "campaignUuid": "019ed1ac-30a6-75be-9204-5a66a318922e",
  "timestamp": "2026-10-14T10:34:49+02:00"
}

Dávkový formát (voliteľný)

Jeden POST nesie pole až 100 udalostí v kľúči events. Každá položka má rovnaké polia ako predvolený formát. Hlavička X-SmartMailer-Event má hodnotu batch.

{
  "events": [
    {
      "event": "open",
      "email": "customer@example.com",
      "campaignUuid": "019ed1ac-30a6-75be-9204-5a66a318922e",
      "timestamp": "2026-10-14T10:34:49+02:00"
    },
    {
      "event": "click",
      "email": "other@example.com",
      "campaignUuid": "019ed1ac-30a6-75be-9204-5a66a318922e",
      "timestamp": "2026-10-14T10:34:50+02:00"
    }
  ]
}

Dávkový formát zapnete pri založení webhooku poľom "batch": true. Bez neho webhook dostáva predvolený formát. Stav vracia GET /api/v1/webhooks v poli batch.

POST /api/v1/webhooks
{
  "url": "https://example.com/smartmailer-webhook",
  "events": ["open", "click", "unsubscribed"],
  "batch": true
}

Hlavičky a podpis

• X-SmartMailer-Event: typ udalosti (open, click, bounce, hardBounce, complaint, unsubscribed), pri dávke batch.
• X-SmartMailer-Signature: HMAC-SHA256 tela požiadavky v hex, kľúčom je secret, ktorý vrátilo založenie webhooku.
• Podpis overujte nad surovým telom požiadavky a porovnávajte v konštantnom čase (hash_equals, timingSafeEqual).

Doručenie a výpadky endpointu

• Na odpoveď čakáme najviac 5 sekúnd. Odpovedajte rýchlo stavom 2xx a náročnejšie spracovanie si dajte do vlastnej fronty.
• Po 5 neúspešných doručeniach za sebou (stav 4xx alebo 5xx, chyba spojenia, vypršaný čas) webhook na 15 minút pozastavíme a udalosti z toho času sa nedoručia. Dokedy pauza trvá, ukazuje pole suspendedUntil v GET /api/v1/webhooks. Po pauze skúsime doručiť znova.
• Neúspešné doručenie neopakujeme. Každú udalosť pošleme najviac raz.
• Výnimočne môže rovnaká udalosť prísť dvakrát. Deduplikujte podľa event, email a campaignUuid.