Webhooks

So funktionieren Webhooks

Wenn in deinem Atlas-Konto etwas passiert, etwa eine neue Buchung, schickt Atlas eine POST-Anfrage an eine Adresse deiner Wahl. Dein Server antwortet innerhalb von zehn Sekunden mit Status 200, dann gilt das Ereignis als zugestellt.

Fehlgeschlagene Zustellungen wiederholt Atlas sechsmal über 24 Stunden, mit wachsenden Pausen dazwischen.

So sieht ein Ereignis aus

Jedes Ereignis hat dieselbe Form. Der Typ sagt, was passiert ist, data enthält das Objekt, um das es geht.

1{2  "id": "evt_3b81",3  "type": "booking.created",4  "created": "2026-10-20T09:14:02Z",5  "data": {6    "booking": "bk_7f2a",7    "starts": "2026-10-24T15:00:00+02:00",8    "service": "Haircut and wash"9  }10}

Signatur prüfen

Jede Anfrage trägt den Header Atlas-Signature. Vergleiche ihn mit deinem eigenen Hash des Bodys, bevor du dem Ereignis vertraust.

1import { createHmac, timingSafeEqual } from 'node:crypto';2 3export function isFromAtlas(body, signature, secret) {4  const expected = createHmac('sha256', secret).update(body).digest('hex');5  return timingSafeEqual(Buffer.from(expected), Buffer.from(signature));6}

Ohne echte Buchungen testen

Im Dashboard unter Entwickler kannst du ein Beispielereignis jedes Typs an deinen Endpunkt schicken und die Antwort ansehen.