Buchung anlegen oder aktualisieren

POST https://app.sendapp.ai/api/bookings

Trägt eine Buchung in den SendApp-Kalender ein. Von dort gehen die eingerichteten Erinnerungen (WhatsApp, SMS oder E-Mail) und, falls aktiv, die Nachfass-Nachrichten hinaus.

Gedacht für Buchungsplattformen, die uns die Daten lieber zusenden, statt abgefragt zu werden: ein Aufruf bei jeder Änderung, und die Erinnerungen laufen von selbst.

Der Aufruf ist idempotent. Das Feld reference ist IHRE Kennung: Wer dieselbe Buchung zweimal sendet, aktualisiert sie, statt sie zu verdoppeln. Ein erneuter Versuch nach einer Zeitüberschreitung schickt demselben Kunden nie zwei Erinnerungen.

Hat Ihr SendApp-Konto mehrere verbundene Konten, ist das Feld token Pflicht: Es legt fest, in welchem Kalender die Buchung landet. Bei nur einem Konto können Sie es weglassen.

Parameter

13 · 4 Pflichtfelder

apikey erforderlich

Ihr API Key (alternativ: der Header X-API-Key).

token optional

Token des Kontos, in das die Buchung eingetragen wird. Pflicht, wenn Sie mehrere haben.

reference erforderlich

Ihre Kennung der Buchung. Erneut gesendet, aktualisiert sie dieselbe Buchung.

start_time erforderlich

Datum und Uhrzeit des Beginns. Akzeptiert 2026-09-12 20:30 oder ISO 8601 (2026-09-12T20:30:00+02:00). Ohne Zeitzone gilt die Zeitzone des Kontos.

end_time optional

Datum und Uhrzeit des Endes. Fehlt die Angabe, wird eine Stunde nach Beginn angenommen.

name erforderlich

Name des Kunden.

phone optional

Telefonnummer im internationalen Format. Pflicht, wenn Sie keine email senden.

email optional

E-Mail des Kunden. Pflicht, wenn Sie kein phone senden.

people optional

Anzahl der Personen: wird in den Notizen der Buchung vermerkt.

notes optional

Freie Notizen (z. B. "Tisch am Fenster").

location optional

Standort oder Raum, falls Sie mehrere haben.

status optional

confirmed (Standard) oder cancelled.

timezone optional

Zeitzone der Buchung (z. B. Europe/Berlin). Fehlt sie, gilt die des Kontos.

Brauchen Sie Hilfe bei der Integration? info@sendapp.live

curl -X POST https://app.sendapp.ai/api/bookings \ -H 'X-API-Key: LA_TUA_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "token": "IL_TUO_ACCOUNT_TOKEN", "reference": "PRE-10432", "start_time": "2026-09-12 20:30", "name": "Mario Rossi", "phone": "+393331234567", "people": 4, "notes": "Tavolo vicino alla finestra" }'

<?php $ch = curl_init('https://app.sendapp.ai/api/bookings'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['X-API-Key: LA_TUA_API_KEY', 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode([ 'token' => 'IL_TUO_ACCOUNT_TOKEN', 'reference' => 'PRE-10432', 'start_time' => '2026-09-12 20:30', 'name' => 'Mario Rossi', 'phone' => '+393331234567', 'people' => 4, ]), ]); $res = json_decode(curl_exec($ch), true); curl_close($ch);

await fetch('https://app.sendapp.ai/api/bookings', { method: 'POST', headers: { 'X-API-Key': 'LA_TUA_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ token: 'IL_TUO_ACCOUNT_TOKEN', reference: 'PRE-10432', start_time: '2026-09-12 20:30', name: 'Mario Rossi', phone: '+393331234567', people: 4, }), });

{ "status": "success", "created": true, "booking": { "reference": "PRE-10432", "token": "IL_TUO_ACCOUNT_TOKEN", "name": "Mario Rossi", "phone": "+393331234567", "email": null, "start_time": "2026-09-12 20:30:00", "end_time": "2026-09-12 21:30:00", "timezone": "Europe/Rome", "status": "confirmed", "notes": "Tavolo vicino alla finestra · 4 persone · REF PRE-10432" } }