Property created

POST

A property was created.

Recipients: AFFILIATE, 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

property.created

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

Summary of a property (hotel).

object

address

Address.

object

addressLine1

string

addressLine2

string

city

string

countryCode

ISO-3166 alpha-2.

string

""

Example

TH

postalCode

string

state

string

currencyCode

Currency code.

string

""

Example

THB

hotelIdentifier

required

Hotel (managing entity) identifier.

string format: uuid

""

lastUpdatedAt

Last change to the property record.

string format: date-time

""

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

location

Geolocation. NOTE: longitude first.

object

latitude

Latitude (y).

number format: double

""

longitude

Longitude (x).

number format: double

""

name

required

Trade name.

string

""

status

Platform status.

string

""

Allowed values: PENDING_APPROVAL ACTIVE INACTIVE UNDER_REVIEW SUSPENDED REJECTED REMOVED

urlName

URL-friendly slug.

string

""

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.