post
https://ari-dev.thehotelplanet.com/v1/push/webhook/pushbook
Register your push-booking webhook URL to receive reservation create and cancel notifications from Nuitee Cloud.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Push-booking webhook
Registration
POST /v1/push/webhook/pushbook
x-api-key: YOUR_KEY
Content-Type: application/json
{ "webhook": "https://partner.example.com/hp/reservations" }Success response:
{ "code": "200", "message": "Webhook request saved successfully" }Delivery channels
| Channel | Description |
|---|---|
| Real-time push | Fired when reservations are created or updated |
| Scheduled job | Hourly batch documented on Cron job – Push booking — confirm schedule and timezone with onboarding |
| Manual | POST /push/webhook/booking — on-demand single booking push when enabled on your contract |
Reservation payload
Nuitee Cloud POSTs reservation JSON to your URL. Field-level documentation and examples are on the Cron job – Push booking page (same payload structure for real-time and scheduled delivery).
Key root fields:
hotelId— supplier property codereservations.reservation[]— one or more reservationsstatus—Confirm(new/confirmed) orCancel(cancelled)paymentcarddetail— virtual card details when applicable
Confirm vs cancel
| Status | Action on your side |
|---|---|
Confirm | Create or update the booking in your PMS |
Cancel | Mark cancelled; stop further processing |
Payment / VCC
Reservations may include Virtual Credit Card (VCC) details in paymentcarddetail. Confirm payment type (Channel Collect, etc.) with onboarding.
Partner responsibilities
- Return HTTP 2xx promptly; process heavy work asynchronously if needed
- Implement idempotent handling by
reservation_id - Accept duplicate POSTs for the same booking
For automated hourly delivery and full payload tables, see Cron job – Push booking.