Create or update a booking

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

Adds a booking to the SendApp Calendar. From there the configured reminders (WhatsApp, SMS or email) go out and, if enabled, the recall messages.

Made for booking platforms that prefer to push the data to us instead of being polled: one call when something changes, and the reminders go out on their own.

It is idempotent. The reference field is YOUR identifier: sending the same booking twice updates it instead of duplicating it. A retry after a timeout never sends two reminders to the same customer.

If your SendApp account has more than one connected account, the token field is required: it tells which calendar the booking goes to. With a single account you can leave it out.

Parameters

13 · 4 required

apikey required

Your API Key (alternatively: the X-API-Key header).

token optional

Token of the account the booking goes to. Required if you have more than one.

reference required

Your identifier for the booking. Sending it again updates the same booking.

start_time required

Start date and time. Accepts 2026-09-12 20:30 or ISO 8601 (2026-09-12T20:30:00+02:00). Without a time zone it is read in the account's time zone.

end_time optional

End date and time. If missing, it is set to one hour after the start.

name required

Customer name.

phone optional

Phone number in international format. Required if you do not send email.

email optional

Customer email. Required if you do not send phone.

people optional

Number of people: added to the booking notes.

notes optional

Free notes (e.g. "table by the window").

location optional

Location or room, if you have more than one.

status optional

confirmed (default) or cancelled.

timezone optional

Time zone of the booking (e.g. Europe/Rome). If missing, the account's one is used.

Need help with the 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" } }