Submit a group request
Write. For 10 or more rooms (individual bookings are capped at 9). The property’s sales team
reviews the request and moves it through under_review → proposal_sent → accepted/declined.
Subscribe to group_request.updated to follow along.
post
https://api.konghotels.cloud/group-requests
Headers
Idempotency-Keystring
Optional. Makes the request safe to retry for 24 hours.
<= 255 characters
Example:8e03978e-40d5-43e8-bc93-6894a57f9324
Body
application/json
Body
application/json
GroupRequestCreate
property_codestringrequired
Example:KTPAR
event_typestringrequired
Allowed values:corporateconferenceweddingsports_teamtour_groupother
group_namestringrequired
contactobjectrequired
Show Child Parameters
check_instring(date)required
check_outstring(date)required
At most 30 nights after check_in.
rooms_requestedintegerrequired
>= 10<= 500
attendeesinteger | null
room_preferencesarray[object]
Show Child Parameters
needs_meeting_spaceboolean
Default:false
budget_per_nightnumber | null
Per room
notesstring | null
Response
application/json
Response
application/json
Group request received.
dataobject
Show Child Parameters
post/group-requests
Authentication
Headers
Body
{
"property_code": "KTPAR",
"event_type": "corporate",
"group_name": "group_name",
"contact": {
"name": "name",
"email": "email"
},
"check_in": "check_in",
"check_out": "check_out",
"rooms_requested": 0
}
application/json
Get a group request
get
https://api.konghotels.cloud/group-requests/{groupReference}
Path Parameters
groupReferencestringrequired
Example:GRP-8K2M4Q
Response
application/json
Response
application/json
The group request.
dataobject
Show Child Parameters
get/group-requests/{groupReference}
Authentication
Path Parameters
application/json
Update a group request
Write. Only while the request is received, under_review or proposal_sent.
patch
https://api.konghotels.cloud/group-requests/{groupReference}
Path Parameters
groupReferencestringrequired
Example:GRP-8K2M4Q
Body
application/json
Body
application/json
GroupRequestUpdate
event_typestring
Allowed values:corporateconferenceweddingsports_teamtour_groupother
group_namestring
contactobject
Show Child Parameters
check_instring(date)
check_outstring(date)
At most 30 nights after check_in.
rooms_requestedinteger
>= 10<= 500
attendeesinteger | null
room_preferencesarray[object]
Show Child Parameters
needs_meeting_spaceboolean
Default:false
budget_per_nightnumber | null
Per room
notesstring | null
Response
application/json
Response
application/json
Updated group request.
dataobject
Show Child Parameters
patch/group-requests/{groupReference}
Authentication
Path Parameters
Body
{}
application/json
Withdraw a group request
Write.
post
https://api.konghotels.cloud/group-requests/{groupReference}/cancel
Path Parameters
groupReferencestringrequired
Example:GRP-8K2M4Q
Response
application/json
Response
application/json
Cancelled group request.
dataobject
Show Child Parameters
post/group-requests/{groupReference}/cancel
Authentication
Path Parameters
application/json
Change Feed
An ordered stream of changes to content, rates, availability and your bookings.