---
title: "NotifyBooking"
method: POST
path: "/NotifyBooking"
tags: ["Callbacks"]
---

# NotifyBooking

`POST /NotifyBooking`

## Request

- Base URL: `https://api.myallocator.com/callback/ota/replace_with_ota_id/v202203`
- URL: `https://api.myallocator.com/callback/ota/replace_with_ota_id/v202203/NotifyBooking`
- Auth: API key in query parameter `shared_secret`

**Endpoint:** `https://api.myallocator.com/callback/ota/{ota}/v202203` (replace `{ota}` with your channel ID)

With this API call the OTA can notify Cloudbeds to immediately request a
`GetBookingList` call based on the `ota_property_id`/`ota_property_sub_id`
and the passed `booking_id`. This should be send on any new booking OR any
changes such as cancellations to an existing booking.

If the `BookingCreate` API call has been implemented then `NotifyBooking`
is not required.

Note: at this time we're not only sending a `GetBookingId` call with the
`booking_id` given in this API call. Cloudbeds instead calls
`GetBookingList` as usual. However, in the future Cloudbeds might
specifically request the booking provided with `NotifyBooking`.

## Request body

- object
  - `ota_property_id` string: Username, login or property ID on the OTA
  - `ota_property_sub_id` string: Property ID on the OTA, if OTA supports multiple properties under one `ota_property_id`/`ota_property_password` combination. See `GetSubProperties` for more details.
  - `booking_id` string: OTA booking ID of the booking to be retrieved.
  - `shared_secret` string, required: Authentication between the OTA and the channel. Identical for all requests. Not to be shared with customers.

## Response `200`

NotifyBooking

- union
  - object: No returned error means the notification has been enqueued into Cloudbeds for import.
    - `Success` true, required: Always `true` on success.
  - ResponseCallbackError
    - `Success` false, required: Always `false` when the response contains an error.
    - `ErrorCode` integer, required: Error code. Check the "Error Codes" section of the specification for valid codes.
    - `Error` string, required: Human-readable error message.

---

[API](https://skmtc.dev/cloudbeds/apis/cloudbeds-ota-build-to-us-api.md) - [All operations](https://skmtc.dev/cloudbeds/apis/cloudbeds-ota-build-to-us-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/cloudbeds-ota-build-to-us-api/revisions/baef9c11c34d?raw)