Booking Created or Updated Webhook
All new bookings or any change that affect bookings previously created should trigger a call to a Wherewolf endpoint, this will cause Wherewolf to fetch the new or updated details.
Cancellations: A cancellation or deletion also needs to trigger a call to Wherewolf, this is required so any pending jobs can be also cancelled.
Note: already checked-in guests will not have their details updated.
Headers:
Content-Type: application/json'
required to indicate the body structure.
Body:
id
id to indicate the booking to be fetched.key
API key provided by Wherewolf.pool
string to identify the target Wherewolf app.
Request example
curl -X POST \
https://api.wherewolf.co.nz/integration/cache \
-H 'Content-Type: application/json' \
-d '{
"id": "ABC123",
"key": "api_key_provided_by_wherewolf",
"pool": "wherewolf_app_identifier"
}'
Response example
{
"success": true,
"bookings": [
{
"id": "ABC123",
...
"web": {
"preArrival": "https://mono.wherewolf.co.nz/QWER12"
}
}
]
}
Response structure details:
success
indicates if we were able to process the payload.bookings
is an array that either will contain 1 item to describe the received booking or be empty. A success response with an empty array indicates Wherewolf accepted the booking but the booking is being ignored, some causes for Wherewolf to ignore bookings are: there is no valid configuration for the product/activity of the booking or the booking status does not indicate it is an active and enabled for use.bookings[0].web.preArrival
when present, is the link that participants of the booking can use to sign waivers. This link can be stored by the booking system and then shared with the participants of the booking. NOTE this might not be present if Wherewolf is not configured with the correct TsCs for the activities/products specified in the booking.bookings[0].web.base
when present, is the link that participants of the booking can use to sign waivers. This link can be stored by the booking system and then shared with the participants of the booking. NOTE this might not be present if Wherewolf is not configured with the correct TsCs for the activities/products specified in the booking.
Pre-arrival links preArrival
vs base
:
preArrival
is the legacy name given to these links, newer apps will return with base
instead of preArrival
. When base
is present, it should be used instead of preArrival
.