Developer docs
Booking lifecycle
The statuses a booking moves through and what triggers each change.
On this page (4)
Statuses
| Status | Meaning |
|---|---|
pending |
Requested and waiting for the business to answer. |
accepted |
Confirmed. The time is reserved. |
rejected |
The business declined the request. |
cancelled |
Cancelled by the business or the customer after it was made. |
completed |
The appointment took place. |
no_show |
The customer did not arrive. |
expired |
The business did not answer a pending request in time. |
Bookings you create through the API
POST /bookingschecks the slot and reserves it. The booking starts aspending.- If the business has auto-accept switched on (
auto_accept_bookingsinGET /business), it becomesacceptedbefore the response is returned. - Otherwise the business is notified and has about 10 minutes to accept (
accept_deadline_at). After that the booking becomesexpiredand the slot is released.
Because your server holds the business's secret key, the API does not send the customer a one-time code. Make sure the phone number you pass belongs to the person booking.
The customer is told by Bewtee when the booking is confirmed, declined or cancelled.
Staff assignment
If you pass staff_id, that person must be free for the whole booking. If you leave it out, Bewtee assigns the first available staff member. The API only offers and accepts times when someone is free, so it never double-books.
Following changes
Subscribe to webhooks to hear about every status change, or poll GET /bookings/{id}.