Account managed-by updated

POST

The entity managing this account on its behalf changed.

Recipients: SELF. 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

managing_entity.managed_by.updated

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 managing entity (account).

object

countryCode

Country of the business address, ISO-3166 alpha-2.

string

""

lastUpdatedAt

Last change to the 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

managingEntityIdentifier

required

Managing entity identifier.

string format: uuid

""

name

required

Display name.

string

""

status

Platform status.

string

""

Allowed values: PENDING_APPROVAL ACTIVE INACTIVE UNDER_REVIEW SUSPENDED REJECTED REMOVED

type

Entity type (HOTEL, TRAVEL_AGENT, …).

string

""

Allowed values: TRIP_PAY FACILITATOR DIRECT APPLICATION HOTEL TRAVELIKO CORPORATE TRAVEL_AGENT INFLUENCER BLOGGER DESTINATION CHANNEL_MANAGER PROPERTY_MANAGEMENT_SYSTEM CENTRAL_RESERVATION_SYSTEM GOOGLE_HOTEL_API MANAGEMENT_COMPANY CHAIN BRAND EVENT_ORGANIZER OTHER

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.