Booking created
A booking was confirmed. Sent to the hotel, and to the reseller / travel agent the booking was made through.
Recipients: AFFILIATE, AGENT, SUPPLIER. Delivery: POST to your registered URL; respond 2xx within 10s. Non-2xx or timeout is retried 10 times over ~3 days (1m, 5m, 30m, 2h, 6h, 12h, then daily); 4xx other than 408/429 is terminal. Wink-Event-Id is your idempotency key. Also raised when: Each booking of a multi-room group booking is delivered as its own booking.create event; correlate with groupIdentifier.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”Example
t=1755000000,v1=5d41402abc4b2a76b9719d911017c592...Signature over t + "." + rawBody. See the security scheme.
Example
0198a4f2-6b0e-7c1d-9a3e-2f4b8c6d1e0aEvent identifier — identical for every endpoint of this recipient and every retry.
Example
0198a4f2-6b0f-7d2e-8b4f-3a5c9d7e2f1bDelivery identifier — unique per subscription endpoint.
Example
booking.createEvent type key (same as type in the body).
Example
11-based attempt number.
Example
2.0Wire contract version.
Request Bodyrequired
Section titled “Request Bodyrequired”object
Unique event identifier. Identical for every endpoint of this recipient and every retry; use it as your idempotency key.
Example
b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47The event payload. Its schema depends on type; every payload carries links.self.
When the event happened on the platform (UTC).
Example
2026-08-15T09:30:00ZThe managing entity this delivery is addressed to.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Why the addressed managing entity receives this event.
Example
SUPPLIERVersion of the payload contract (the shape of object). Currently 2.
Example
2Event type key, e.g. booking.create. The list of keys is documented under Webhooks.
Example
booking.createSummary of a booking: what an integrator needs to act on a booking event. Fetch links.self for the full record.
object
The person who made the booking (may be an agent rather than the traveler).
object
Email.
First name.
Last name.
Telephone.
User-friendly confirmation code.
Example
WNK4ZQ7PBooking identifier.
Present when the booking is cancelled.
object
Cancellation policy type applied.
When the booking was cancelled.
Who cancelled.
Free-text reason.
When the booking was created.
UUID grouping the bookings of a single multi-room transaction, if any.
The lead guest assigned to the stay, when different from the booker.
object
Email.
First name.
Last name.
Telephone.
The property booked.
object
Hotel currency code.
Example
THBHotel (managing entity) identifier.
Hotel trade name.
When the booking record last changed.
Links to fetch the full resource this event is about. self is the SUPPLIER-side canonical resource URL (/api/managing-entity/{hotel}/extranet/…). AFFILIATE and AGENT recipients cannot call it — use your own reseller/agent endpoints for the same resource id.
object
Absolute URL of the resource, on the SUPPLIER-side canonical path (/api/managing-entity/{hotel}/extranet/…). If you receive this event as an AFFILIATE or AGENT rather than the supplier, call your own reseller/agent endpoint for the same resource id instead — the REST ACL applies either way.
Example
https://api.wink.travel/api/managing-entity/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51/extranet/booking/9c7d6e4f-0a8b-2c51-3c6b-1a5d8e2f4a0bPresent when a refund exists.
object
Refunded amount in the property’s currency.
object
Amount, as a decimal.
Example
450ISO-4217 currency code.
Example
USDWhen the refund was processed, if it has been.
Refund reason.
Refund identifier.
When the refund was requested.
Refund status.
How much of the captured amount has come back: FULL, PARTIAL, or NONE when no settled refund exists. Derived from the refund ledger rather than from status — a refunded booking that was not cancelled reports PAYMENT_SUCCEEDED in status, so read this field to detect a refund, not that one.
The reseller / sales-channel context the booking was made under, if any.
object
Managing entity identifier of the reseller / sales-channel owner.
Reseller display name.
Booking lifecycle status.
Dates, occupancy and room/rate plan.
object
Adults.
Example
2Check-in date.
Check-out date.
Children.
Example
0Number of nights.
Example
3Identical rooms booked.
Example
1Rate plan identifier.
Rate plan name.
Room type identifier.
Room type name.
Gross stay total in the property’s currency.
object
Amount, as a decimal.
Example
450ISO-4217 currency code.
Example
USDResponses
Section titled “Responses”Acknowledged. Any 2xx marks the delivery SUCCEEDED.
Rejected. Terminal (no retry) except 408 and 429, which are retried.
Failed. Retried per the schedule above.