Add a party to the waitlist
Adds a party to the end of the queue and returns its entry with its position and quoted wait. A closed waitlist answers 409 waitlist_closed; a phone Maple cannot text, such as one with an extension, answers 400. Requires bookings:write.
Authorizations
API key — mpk_test_… for the sandbox, mpk_live_… for production. Issued by Maple during partner onboarding.
Body
A granted location.
x >= 1Your unique key for this join, scoped to your app across all its locations. Retrying with the same key and the same request returns the same entry; the same key with a different request, including another location, answers 409 idempotency_key_reused.
1 - 255Response
Success
waitlist_entry Opaque, prefixed bkw_….
waiting, notified, on_my_way, seated, removed_by_guest, removed_by_venue, expired_no_response 1-based place in the queue while the entry is active; null once it is seated, removed, or expired.
The wait quoted when the party joined, refreshed when it is notified. Null when none could be quoted.
ISO-8601 UTC instant.
ISO-8601 UTC instant the table-ready text was sent.
The walk-in booking created when the party was seated; read it with GET /bookings/{bookingId}.
The channel the party joined on, e.g. api_partner, voice_ai, internal.