Submit a booking / appointment request

Creates a PENDING reservation. The merchant confirms in Dashboard (business-ops). Owner may be notified via in-app, WhatsApp, or WeChat when configured. Not a guaranteed instant booking.

post/api/v1/b/{handle}/reservations

Request

  • Base URL: https://www.trusgent.com
  • URL: https://www.trusgent.com/api/v1/b/{handle}/reservations
  • Auth: one of:
    • none
    • HTTP bearer

Path parameters

handlestring required
Example:TG-S-839201

Public facade handle — same as AgentID (agentId).

Request body

mode'table' | 'appointment'

table for dine-in; appointment for generic services

namestring required
phonestring required
emailstring email
partySizeinteger required
datestring required

YYYY-MM-DD

timestring required

HH:mm

notestring
tablestring

Optional table code from facade.tables

servicestring

Optional service label

Example request

{
  "date": "2026-09-02",
  "time": "19:00"
}

Response

Reservation created (pending merchant confirmation)

kindstring
idstring

Reservation ID

statusstring
handlestring
opsHintstring

Example response

{
  "kind": "BusinessReservation",
  "status": "PENDING"
}

Changes

No recorded changes to this operation across all 1 revision of this API.