Review responded

POST

The hotel responded to a guest review. Sent to the booking’s parties.

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.

Authorizations

• winkWebhookSignature

Parameters

Header Parameters

Wink-Signature

required

string

Example

t=1755000000,v1=5d41402abc4b2a76b9719d911017c592...

Signature over t + "." + rawBody. See the security scheme.

Wink-Event-Id

required

string

Example

0198a4f2-6b0e-7c1d-9a3e-2f4b8c6d1e0a

Event identifier — identical for every endpoint of this recipient and every retry.

Wink-Delivery-Id

required

string

Example

0198a4f2-6b0f-7d2e-8b4f-3a5c9d7e2f1b

Delivery identifier — unique per subscription endpoint.

Wink-Event-Type

required

string

Example

booking.review.responded

Event type key (same as type in the body).

Wink-Delivery-Attempt

required

string

Example

1

1-based attempt number.

Wink-Version

required

string

Example

2.0

Wire contract version.

Request Body^required

Media typeapplication/json

object

id

required

Unique event identifier. Identical for every endpoint of this recipient and every retry; use it as your idempotency key.

string format: uuid

""

Example

b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47

object

required

The event payload. Its schema depends on type; every payload carries links.self.

""

occurredAt

required

When the event happened on the platform (UTC).

string format: date-time

""

Example

2026-08-15T09:30:00Z

ownerIdentifier

required

The managing entity this delivery is addressed to.

string format: uuid

""

Example

d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69

recipientRole

required

Why the addressed managing entity receives this event.

string

""

Allowed values: SUPPLIER AFFILIATE AGENT SELF

Example

SUPPLIER

schemaVersion

required

Version of the payload contract (the shape of object). Currently 2.

integer format: int32

""

Example

2

type

required

Event type key, e.g. booking.create. The list of keys is documented under Webhooks.

string

""

Example

booking.create

object

required

A hotel’s response to a guest review.

object

approvedImage

Hotel approved the guest’s image for public display.

boolean

approvedText

Hotel approved the guest’s text for public display.

boolean

bookingCode

Booking confirmation code.

string

""

bookingIdentifier

required

Booking the review belongs to.

string format: uuid

""

hotelIdentifier

required

Hotel that responded.

string format: uuid

""

links

required

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

self

required

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.

string format: uri

""

Example

https://api.wink.travel/api/managing-entity/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51/extranet/booking/9c7d6e4f-0a8b-2c51-3c6b-1a5d8e2f4a0b

responseFromHotel

required

The hotel’s response text.

string

""

reviewIdentifier

Review identifier, when the booking carries the review.

string format: uuid

""

Responses

2XX

Acknowledged. Any 2xx marks the delivery SUCCEEDED.

4XX

Rejected. Terminal (no retry) except 408 and 429, which are retried.

5XX

Failed. Retried per the schedule above.