Sync updates

Configure webhooks to receive real-time updates for events directly into your system.

Configuration

Please contact our Support Team at support@zealconnect.com and provide:

Endpoint URL — The HTTPS URL on your server to receive webhook events

Access Key — Authentication token/key required to call your endpoint

Once received, our team will configure the webhook and confirm when events are live.

Your webhook endpoint must be publicly accessible over HTTPS with a valid SSL certificate.

Endpoint URL Format

We recommend structuring your webhook endpoint URL to include the BookingCode
as a path parameter so each event can be easily identified and routed on your side.

Recommended format:

https://yourdomain.com/webhooks/bookings/{bookingCode}

Example:

https://yourdomain.com/webhooks/bookings/BK-00123456

This allows your server to immediately identify which booking the incoming
event relates to without needing to parse the request body first.

Note: The exact URL structure is flexible — the above is a recommendation.
What matters is that the endpoint is publicly accessible over HTTPS and
secured with your Access Key.

Response Requirements

Your endpoint must return an HTTP 200 OK response upon successfully receiving
the webhook event. This confirms to ZealConnect that the event was delivered.

Events

Our Webhook system pushes data to your configured endpoint whenever a booking status changes:

Booking Confirmed: Triggers when a booking is confirmed in the system.

Booking Escalated: Triggers when a booking is escalated.

Sample Payload

Below is an example of a JSON object you might receive for a confirmed booking:

{
    "POCName": "John Smith",
    "POCDepartment": "Reservations",
    "Remark": "Guest requested late check-in approved",
    "ReconfirmationStatus": "CONFIRMED",
    "UpdatedBy": "Username",
    "HCN": "HCN-2024-8892",
    "Channel": "HOTEL_CALL",
    "UpdatedOn": "2024-03-15T14:30:00Z",
    "POCContact": "+1-555-0123"
}

Field Reference

The following table details the data types and expected values for each field in the payload.

Field	Type	Description
POCName	`String`	Name of the Point of Contact handling the booking.
POCDepartment	`String`	The department associated with the POC (e.g., Reservations).
Remark	`String`	Any notes, comments, or special requests regarding the update.
ReconfirmationStatus	`Enum`	The current status of the booking. Allowed Values: `CONFIRMED`, `ESCALATED`, `CANCELLED`, `PENDING`, `EXCLUDED`
UpdatedBy	`String`	Name of the user or system agent who performed the update.
HCN	`String`	The unique Hotel/Booking Confirmation Number.
Channel	`String`	The source channel of the booking.
UpdatedOn	`Date-Time`	The timestamp of the update in ISO 8601 format.
POCContact	`String`	Phone number or contact details for the Point of Contact.

Configuration#

Endpoint URL Format#

Response Requirements#

Events#