Kong Hotels Partner API

Send a test event

Write. Queues a signed webhook.ping delivery to the endpoint.

post
https://api.konghotels.cloud/webhooks/{webhookId}/ping

Path Parameters

webhookIdstringrequired

Match pattern:^whk_

Response

application/json

Ping queued.

dataobject
Show Child Parameters
post/webhooks/{webhookId}/ping
 
application/json

Rotate the signing secret

Write. Issues a new secret; the old one stops working immediately.

post
https://api.konghotels.cloud/webhooks/{webhookId}/rotate-secret

Path Parameters

webhookIdstringrequired

Match pattern:^whk_

Response

application/json

Subscription with its new secret.

dataobject
Show Child Parameters
post/webhooks/{webhookId}/rotate-secret
 
application/json

List delivery attempts

get
https://api.konghotels.cloud/webhooks/{webhookId}/deliveries

Query Parameters

per_pageinteger

>= 1<= 100

cursorstring

Opaque cursor from meta.next_cursor / links.next.

Path Parameters

webhookIdstringrequired

Match pattern:^whk_

Response

application/json

Deliveries, newest first.

linksobject
Show Child Parameters
metaobject
Show Child Parameters
dataarray[object]
Show Child Parameters
get/webhooks/{webhookId}/deliveries
 
application/json

changeEvent

WEBHOOK

Sent to each matching subscription. Verify Kong-Signature before trusting the body.

post
https://api.konghotels.cloud

Headers

Kong-Eventstringrequired

Allowed values:reservation.createdreservation.modifiedreservation.cancelledreservation.add_ons_changedavailability.changedrates.changedproperty.updatedpromotion.publishedreview.publishedgroup_request.createdgroup_request.updatedwebhook.ping

Kong-Deliverystringrequired

Example:dlv_01jbx5c0w4c1x2y3z4a5b6c7d8

Kong-Signaturestringrequired

Example:t=1792821234,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd

Body

application/json

ChangeEvent

idstring

Example:evt_01jbx5a1b2c3d4e5f6g7h8j9k0

sequenceinteger

Monotonic position in the feed; use as the since cursor.

typestring

Allowed values:reservation.createdreservation.modifiedreservation.cancelledreservation.add_ons_changedavailability.changedrates.changedproperty.updatedpromotion.publishedreview.publishedgroup_request.createdgroup_request.updatedwebhook.ping

occurred_atstring(date-time)
property_codestring | null
subjectobject
Show Child Parameters
dataobject

Payload by event type:

Type data fields
availability.changed room_type_code, start_date, end_date (inclusive stay nights). Refetch availability for that range.
rates.changed room_type_code, start_date, end_date, rate_plan_codes, lowest_rate (current lowest nightly base rate in the range), currency
property.updated changed_sections (any of description, amenities, photos, policies), summary
promotion.published code, name, bookable_until, property_codes (null = all)
review.published review_id, overall_rating
reservation.created / .modified / .cancelled / .add_ons_changed confirmation_number, partner_reference, status, check_in, check_out, total, currency, plus changed_fields (modified), cancellation_fee (cancelled) or add_ons (add-ons changed). Status changes made at the property, such as check-in and check-out, arrive as reservation.modified.
group_request.created / .updated reference, status, rooms_requested
webhook.ping message
* Additional properties are allowed.

Response

200

Any 2xx acknowledges the delivery.

post

Body

{ "id": "evt_01jbx5a1b2c3d4e5f6g7h8j9k0", "sequence": 4182, "type": "availability.changed", "occurred_at": "2026-10-24T05:54:42Z", "property_code": "KTNYC", "subject": { "type": "room_type", "id": "KTNYC:TWRK" }, "data": { "room_type_code": "TWRK", "start_date": "2026-12-04", "end_date": "2026-12-06" } }
200

Problem

object

RFC 9457 problem details. Extra members (e.g. available_units, restrictions, reasons) may be present.

* Additional properties are allowed.
typestring(uri)required
titlestringrequired
statusintegerrequired
detailstring
instancestring
request_idstring
Example