Crear o actualizar una reserva

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

Añade una reserva a la Agenda de SendApp. Desde allí salen los recordatorios configurados (WhatsApp, SMS o email) y, si están activos, los mensajes de seguimiento.

Pensado para las plataformas de reservas que prefieren enviarnos los datos en lugar de ser consultadas: una llamada cuando algo cambia, y los recordatorios salen solos.

Es idempotente. El campo reference es TU identificador: si envías dos veces la misma reserva, la actualizas en lugar de duplicarla. Un reintento tras un timeout nunca envía dos recordatorios al mismo cliente.

Si tu cuenta de SendApp tiene varias cuentas conectadas, el campo token es obligatorio: indica en qué agenda termina la reserva. Con una sola cuenta puedes omitirlo.

Parámetros

13 · 4 obligatorios

apikey obligatorio

Tu API Key (como alternativa: la cabecera X-API-Key).

token opcional

Token de la cuenta en la que guardar la reserva. Obligatorio si tienes más de una.

reference obligatorio

Tu identificador de la reserva. Al reenviarlo actualizas la misma reserva.

start_time obligatorio

Fecha y hora de inicio. Acepta 2026-09-12 20:30 o ISO 8601 (2026-09-12T20:30:00+02:00). Sin zona horaria se interpreta en la zona de la cuenta.

end_time opcional

Fecha y hora de fin. Si falta, se fija una hora después del inicio.

name obligatorio

Nombre del cliente.

phone opcional

Teléfono en formato internacional. Obligatorio si no envías email.

email opcional

Email del cliente. Obligatorio si no envías phone.

people opcional

Número de personas: se añade a las notas de la reserva.

notes opcional

Notas libres (p. ej. "mesa junto a la ventana").

location opcional

Sede o sala, si tienes más de una.

status opcional

confirmed (predeterminado) o cancelled.

timezone opcional

Zona horaria de la reserva (p. ej. Europe/Madrid). Si falta, se usa la de la cuenta.

¿Necesitas ayuda con la integración? 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" } }