Add a link to another booking platform.
PUT/listings/:listing_id/ota_links
Links the listing to its page on another booking platform, or sets its direct booking website. The link is recorded as added by the API key's user, with source user.
For airbnb, vrbo and booking_com, url must be a listing page on that platform. Wheelhouse may not have data for the page yet, in which case it is returned with known: false and filled in later. Adding a page a user already linked has no effect. Adding a page only the PMS or a bulk upload links adds a user source next to it, which keeps the page linked if the PMS stops sending it.
For direct, url replaces the listing's direct booking website. A URL without a scheme gets http://.
Requires owner, manager or editor access to the listing (restricted editors included); viewers get 403.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 406
- 422
- 429
All of the listing's links, including the one added.
platform or url is missing, or platform is not one of the listed values.
API key authorization failed.
Listing authorization failed (including a viewer on a shared listing), or the API key is read-only and may not be used with PUT.
Listing not found.
The listing is inactive. See the Inactive Listings section in the overview.
The URL is not valid, or is not a listing page on the given platform.
Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the Rate Limits section in the overview for the recommended exponential backoff strategy.