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

# NotifyBooking

`POST /NotifyBooking`

**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.net/cloudbeds/apis/cloudbeds-api.md) · [All operations](https://skmtc.net/cloudbeds/apis/cloudbeds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudbeds/cloudbeds-api/revisions/2faa857793e8/schema)