Overview

What is the ConsumerTrip Event Listener?

The ConsumerTrip Event Listener is an API that allows partners to notify Holibob about booking events in real time. When a consumer makes, updates, or cancels a booking on your platform, you send an event to this API so Holibob can keep consumer trip data in sync.

Base URL

Environment	URL
Production	https://webhook.production.holibob.tech

Authentication

Every request must include a secret path parameter. This is a security secret provided to you by Holibob during onboarding. It is included directly in the URL path.

POST https://webhook.production.holibob.tech/booking-event/create/{secret}

If the secret is invalid, the API responds with a 403 Forbidden error:

{
  "message": "Invalid secret"
}

Content types

The API accepts both application/json and application/x-www-form-urlencoded content types.

Response format

All successful requests return:

{
  "success": true
}

Validation errors return a 422 status with details about the violated rules:

{
  "message": "Invalid data",
  "violationList": [
    {
      "message": "String must contain at least 10 character(s)",
      "propertyPath": ["consumerPhone"]
    }
  ]
}