Créer ou modifier une réservation

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

Ajoute une réservation à l'Agenda de SendApp. C'est de là que partent les rappels configurés (WhatsApp, SMS ou e-mail) et, s'ils sont activés, les messages de relance.

Conçu pour les plateformes de réservation qui préfèrent nous envoyer les données plutôt que d'être interrogées : un appel quand quelque chose change, et les rappels partent tout seuls.

C'est idempotent. Le champ reference est VOTRE identifiant : envoyer deux fois la même réservation la met à jour au lieu de la dupliquer. Une nouvelle tentative après un délai dépassé n'envoie jamais deux rappels au même client.

Si votre compte SendApp a plusieurs comptes connectés, le champ token est obligatoire : il indique dans quel agenda va la réservation. Avec un seul compte, vous pouvez l'omettre.

Paramètres

13 · 4 obligatoires

apikey obligatoire

Votre API Key (ou bien l'en-tête X-API-Key).

token facultatif

Token du compte où enregistrer la réservation. Obligatoire si vous en avez plusieurs.

reference obligatoire

Votre identifiant de la réservation. Le renvoyer met à jour la même réservation.

start_time obligatoire

Date et heure de début. Accepte 2026-09-12 20:30 ou ISO 8601 (2026-09-12T20:30:00+02:00). Sans fuseau horaire, elle est lue dans le fuseau du compte.

end_time facultatif

Date et heure de fin. Si elle manque, elle est fixée à une heure après le début.

name obligatoire

Nom du client.

phone facultatif

Téléphone au format international. Obligatoire si vous n'envoyez pas email.

email facultatif

E-mail du client. Obligatoire si vous n'envoyez pas phone.

people facultatif

Nombre de personnes : ajouté aux notes de la réservation.

notes facultatif

Notes libres (par ex. "table près de la fenêtre").

location facultatif

Établissement ou salle, si vous en avez plusieurs.

status facultatif

confirmed (par défaut) ou cancelled.

timezone facultatif

Fuseau horaire de la réservation (par ex. Europe/Paris). S'il manque, celui du compte est utilisé.

Besoin d'aide pour l'intégration ? 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" } }