Buchung anlegen

POST/v1/bookings

Legt eine Buchung an und schickt dem Kunden die Bestätigung. Ist der Termin schon vergeben, kommt 409 mit dem nächsten freien Termin zurück.

Parameter

  • servicestringPflicht

    Die ID der Leistung, etwa svc_haircut.

  • startsdatetimePflicht

    Beginn im Format ISO 8601 mit Zeitzone.

  • customerobjectPflicht

    Name und E-Mail. Mit einer bekannten E-Mail wird der bestehende Kunde verwendet.

  • staffstringoptional

    Eine Person aus dem Team. Ohne Angabe wählt Atlas, wer frei ist.

  • notestringoptional

    Eine Notiz für das Team, bis 500 Zeichen.

Anfrage

const res = await fetch('https://api.atlas.example/v1/bookings', {  method: 'POST',  headers: { Authorization: `Bearer ${key}` },  body: JSON.stringify({ service: 'svc_haircut', starts, customer }),});

Antwort

201 Created
{  "id": "bk_7f2a",  "status": "confirmed",  "starts": "2026-10-24T15:00:00+02:00",  "confirmation_url": "https://atlas.example/b/7f2a"}