Read the change feed

An append-only, ordered feed of events. Public events (rates, availability, content, promotions,
reviews) are visible to everyone; reservation and group-request events only to the partner that
owns them.

Start with since=0, process the events in order, store meta.next_cursor, and pass it as since
next time. Keep calling straight away while meta.has_more is true.

get
https://api.konghotels.cloud/changes

Query Parameters

sinceinteger

The sequence number to read after.

Default:0

>= 0

typesstring

Comma-separated event types to include.

Example:availability.changed,rates.changed

propertystring
limitinteger

Default:100

>= 1<= 500

Response

200 application/json

Events after the cursor.

dataarray[object]

Example:{"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"}}

Show Child Parameters
metaobject
Show Child Parameters
get/changes
 
200 application/json

Webhooks

Push delivery of change events to your endpoints.

List event types

get
https://api.konghotels.cloud/webhooks/event-types

Response

200 application/json

Subscribable event types.

dataarray[object]
Show Child Parameters
get/webhooks/event-types
 
200 application/json

List subscriptions

get
https://api.konghotels.cloud/webhooks

Response

200 application/json

Your subscriptions.

dataarray[object]
Show Child Parameters
get/webhooks
 
200 application/json

Create a subscription

Write. The signing secret is returned only in this response (and after rotation). Store it securely.

post
https://api.konghotels.cloud/webhooks

Headers

Idempotency-Keystring

Optional. Makes the request safe to retry for 24 hours.

<= 255 characters

Example:8e03978e-40d5-43e8-bc93-6894a57f9324

Body

application/json

WebhookCreate

urlstring(uri)required

Must be HTTPS in production.

eventsarray[string]required

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

>= 1 items

property_codesarray | null[string]

Only events for these properties; null for all.

descriptionstring | null
is_activeboolean

Default:true

Response

application/json

Subscription created.

dataobject
Show Child Parameters
post/webhooks

Body

{ "url": "https://partner.example.com/webhooks/kong-hotels", "events": [ "reservation.created", "reservation.modified", "reservation.cancelled", "availability.changed" ], "property_codes": [ "KTNYC", "KBBRK" ], "description": "Production listener" }
 
application/json