Use these endpoints to push sales transactions and booking status changes from your POS into NowBookIt. NowBookIt matches each incoming event to the relevant booking, updates the NowBookIt Diary, and records the sale.
These endpoints require custom configuration per partner. The request body format is not prescribed — your system sends its native payload, and NowBookIt builds a custom handler during onboarding that maps your specific fields to NowBookIt’s data model.Changes to your payload structure must be communicated to your NowBookIt partner manager so the handler can be updated.
POST Sales/partners/{partnerName}/events/{eventType}
The primary endpoint for sales and booking sync. Push order-closed, order-updated, or any booking-related events from your POS.
Path parameters
| Parameter | Description |
|---|
partnerName | Your registered partner identifier |
eventType | Event name as defined by your system (e.g. order.created, order.updated, table.closed) |
- Identify the venue (
locationId or equivalent)
- Match the sale to a booking (via booking ID or table number)
- Extract the sale amount and items
Processing behaviour
- If
eventType is webhooks.test_notification, NowBookIt returns 200 immediately with no processing
- NowBookIt resolves the venue from the
locationId in your payload
- Sales are matched to bookings via booking ID or table number
- Processing is idempotent — resubmitting the same sale ID updates the existing record
Responses
| Status | Description |
|---|
200 | Processed, or silently ignored (location not found, integration not enabled, unrecognised model) |
400 | Partner not recognised, or signature invalid/missing |
409 | Same sale is currently being processed — retry after ~1 minute |
500 | Sales processing failed |
POST partners/{partnerName}/webhooks/callback/{eventType}
Generic event callback. Use for any event type that needs to be routed to your NowBookIt integration handler.
Path parameters
| Parameter | Description |
|---|
partnerName | Your registered partner identifier |
eventType | The event name as defined by your system |
| Status | Description |
|---|
200 | Event processed successfully |
400 | Partner name not recognised, or signature invalid/missing |
500 | Event processing failed |
