1. Reconfirmation APIs
Zeal Reconfirmation
  • Getting Started
  • Sync Updates (Webhooks)
  • Error Codes Reference
  • Reconfirmation APIs
    • Add Bookings
      POST
    • Update Booking
      PATCH
  • Resources
  • Schemas
    • Add Bookings
    • Update Booking
  1. Reconfirmation APIs

Add Bookings

POST
https://reconfirmation.integrators.zealconnect.com/addBookings

Add Bookings#

Submit one or more hotel bookings to ZealConnect Reconfirmation for processing.
Bookings are validated, queued, and processed asynchronously. Upon success, a traceId is returned for each batch, which can be used for tracking and reconciliation.

When to Call This Endpoint#

Call this endpoint immediately when a hotel booking is confirmed in your system.
Real-time push is strongly recommended — delayed or batched submissions increase reconfirmation risk.

Important Notes#

Send bookings immediately upon confirmation — do not batch or delay.
BookingCode must be unique and consistent. It is used to identify the booking in all future update requests.
If BookingSubCode is provided at submission, it must also be included in all subsequent update requests using the format BookingCode#BookingSubCode.
Bookings submitted via this endpoint are processed asynchronously and may take up to 5 minutes to reflect in the system.

What to Expect#

A successful API response confirms the booking was accepted for processing —
not that it has been fully processed.
Use the returned traceId to track the status of your submission.
If the booking does not appear in the system within 5 minutes, please contact
ZealConnect Support for assistance.
Note: Do not resubmit the same booking while waiting for it to appear.
Duplicate submissions may result in multiple bookings being created.

Rebooking#

A rebooking occurs when an existing booking is cancelled and replaced with a new one.
To handle this correctly, pass the following fields in your request:
FieldValueDescription
LineCodePass the booking sub code or line code.
EventTypeREBOOKSignals ZealConnect to treat this as a rebooking event.

Behavior#

ZealConnect handles the rebooking differently depending on the status of the existing reconfirmation booking:
Previous Booking StatusBehavior
Pending / Not yet confirmedCancels the existing reconfirmation booking and creates a new one.
CONFIRMED or ESCALATEDPrevious booking is left unchanged. The new booking is created as a fresh entry.

Important Notes#

Always pass EventType as REBOOK when a rebooking occurs in your system — do not submit it as a standard new booking.
If the previous booking was CONFIRMED or ESCALATED, ZealConnect will not cancel it automatically. You are responsible for managing the cancellation separately if needed.
The supplierRef passed as BookingSubCode must match the reference used in the original booking submission for ZealConnect to correctly identify and link the records.

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Accepted
application/json
Bookings have been validated and successfully queued for reconfirmation processing. Use the traceIds to track batches in your logs.
Body

🟠403Invalid API Key
🔴500Internal Server Error
🟠401Unauthorized
🟠400Invalid Request Body
🟠400Schema Validation Failed
🔴502Queue Publish Failed
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://reconfirmation.integrators.zealconnect.com/addBookings' \
--header 'x-account-id: ZC_ORG_LIVE' \
--header 'x-api-key: your-api-key' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "BookingCode": "BK20260311001",
        "LineCode": "458721",
        "EventType": "BOOK",
        "CheckIn": "2026-04-10T14:00:00Z",
        "CheckOut": "2026-04-15T11:00:00Z",
        "BookingDate": "2026-03-11T09:45:00Z",
        "CancellationDeadLine": "2026-04-03T09:45:00Z",
        "Source": "API",
        "ChannelId": "B2B",
        "BookingAmount": 1250,
        "Currency": "USD",
        "Refundable": true,
        "BookingPriority": 1,
        "Agency": {
            "Name": "Global Travel Services",
            "ReferenceNo": "AG-778921"
        },
        "Supplier": {
            "Name": "HotelBeds",
            "ReferenceNo": "HB-99123456",
            "HCN": "HCN458721"
        },
        "Hotel": {
            "Name": "Hilton Dubai Palm Jumeirah",
            "Country": "United Arab Emirates",
            "CountryCode": "AE",
            "City": "Dubai",
            "State": "Dubai",
            "Address": "Palm West Beach, Palm Jumeirah",
            "PostalCode": "213208",
            "Rating": 5,
            "Latitude": "25.112345",
            "Longitude": "55.139876",
            "MasterProvider": "JUNIPER",
            "MasterHotelId": "JP45872",
            "ContactDetails": {
                "PhoneNumbers": [
                    "+97144567890",
                    "+97144567891"
                ],
                "Emails": [
                    "reservations@hiltondubai.com",
                    "info@hiltondubai.com"
                ]
            }
        },
        "Guest": {
            "LeadName": "John Smith",
            "TotalRooms": 2,
            "Adults": 3,
            "Childs": 1,
            "Infants": 0,
            "Nationality": "British",
            "Country": "United Kingdom",
            "City": "London",
            "Address": "221B Baker Street",
            "AllGuests": [
                {
                    "Name": "John",
                    "LastName": "Smith",
                    "Title": "Mr",
                    "Age": 40,
                    "Type": "Adult",
                    "Gender": "Male",
                    "Email": "john.smith@email.com",
                    "PhoneNumber": "+447700900111",
                    "Country": "United Kingdom"
                },
                {
                    "Name": "Emily",
                    "LastName": "Smith",
                    "Title": "Mrs",
                    "Age": 38,
                    "Type": "Adult",
                    "Gender": "Female",
                    "Email": "emily.smith@email.com",
                    "PhoneNumber": "+447700900112",
                    "Country": "United Kingdom"
                },
                {
                    "Name": "Daniel",
                    "LastName": "Smith",
                    "Title": "Mr",
                    "Age": 12,
                    "Type": "Child",
                    "Gender": "Male",
                    "Email": "daniel.smith@email.com",
                    "PhoneNumber": "+447700900113",
                    "Country": "United Kingdom"
                },
                {
                    "Name": "Michael",
                    "LastName": "Smith",
                    "Title": "Mr",
                    "Age": 35,
                    "Type": "Adult",
                    "Gender": "Male",
                    "Email": "michael.smith@email.com",
                    "PhoneNumber": "+447700900114",
                    "Country": "United Kingdom"
                }
            ],
            "RoomStructure": [
                {
                    "BoardType": "Breakfast",
                    "RoomType": "Deluxe Sea View",
                    "Adults": 2,
                    "Childs": 1,
                    "Infants": 0
                },
                {
                    "BoardType": "Breakfast",
                    "RoomType": "Deluxe Sea View",
                    "Adults": 1,
                    "Childs": 0,
                    "Infants": 0
                }
            ]
        },
        "SpecialRequest": "Late check-in expected around 22:00."
    }
]'
Response Response Example
200 - Success
Booking was validated and queued successfully.
{
    "status": "ACCEPTED",
    "message": "Bookings have been successfully queued for processing.",
    "data": {
        "traceIds": ["a1b2c3d4-5678-90ab-cdef-1234567890ab"],
        "bookingsCount": 1
    },
    "meta": {
        "requestId": "req-7fXmP9kL2nQr",
        "timestamp": "2026-01-21T14:30:00.000Z"
    }
}
Modified at 2026-03-24 17:43:38
Previous
Error Codes Reference
Next
Update Booking
Built with