Criar ou atualizar uma reserva

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

Acrescenta uma reserva à Agenda do SendApp. É daí que saem os lembretes configurados (WhatsApp, SMS ou email) e, se estiverem ativos, as mensagens de seguimento.

Pensado para as plataformas de reservas que preferem enviar-nos os dados em vez de serem consultadas: uma chamada quando algo muda, e os lembretes saem sozinhos.

É idempotente. O campo reference é o SEU identificador: enviar duas vezes a mesma reserva atualiza-a em vez de a duplicar. Uma nova tentativa depois de um timeout nunca envia dois lembretes ao mesmo cliente.

Se a sua conta SendApp tiver várias contas ligadas, o campo token é obrigatório: indica em que agenda fica a reserva. Com uma só conta pode omiti-lo.

Parâmetros

13 · 4 obrigatórios

apikey obrigatório

A sua API Key (em alternativa: o cabeçalho X-API-Key).

token opcional

Token da conta onde guardar a reserva. Obrigatório se tiver mais do que uma.

reference obrigatório

O seu identificador da reserva. Voltar a enviá-lo atualiza a mesma reserva.

start_time obrigatório

Data e hora de início. Aceita 2026-09-12 20:30 ou ISO 8601 (2026-09-12T20:30:00+02:00). Sem fuso horário, é lida no fuso da conta.

end_time opcional

Data e hora de fim. Se faltar, é fixada uma hora depois do início.

name obrigatório

Nome do cliente.

phone opcional

Telefone em formato internacional. Obrigatório se não enviar email.

email opcional

Email do cliente. Obrigatório se não enviar phone.

people opcional

Número de pessoas: acrescentado às notas da reserva.

notes opcional

Notas livres (p. ex. "mesa junto à janela").

location opcional

Local ou sala, se tiver mais do que um.

status opcional

confirmed (por omissão) ou cancelled.

timezone opcional

Fuso horário da reserva (p. ex. Europe/Lisbon). Se faltar, usa-se o da conta.

Precisa de ajuda com a integração? 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" } }