# Add a link to another booking platform.

`PUT /listings/{listing_id}/ota_links`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-put-ota-link · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmPutOtaLink` · Tag: Listing 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

`PUT https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/ota_links`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Modifies data; read-only keys get `403 Forbidden`.

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `listing_id` | string | yes | The channel's unique listing identifier, or the Wheelhouse listing ID when `channel` is `wheelhouse`. |

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `channel` | string | yes | Channel name the listing is on (the `channel` field of the [/listings](https://docs.usewheelhouse.com/rm/reference/rm-get-listings.md) response), or the literal `wheelhouse` to read `listing_id` as a Wheelhouse listing ID instead. See [Identifying Listings](https://docs.usewheelhouse.com/rm/concepts/listings.md). |

### Request body (`application/json`, required)

- `platform` (string, required, one of: `airbnb`, `booking_com`, `direct`, `vrbo`): The platform the URL is on, or `direct` for the listing's direct booking website.
- `url` (string, required, example: `https://www.airbnb.com/rooms/12345678`): The listing's page on that platform, or its direct booking website.

### Example request

```bash
curl -X PUT 'https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/ota_links?channel=<channel>' \
  -H 'X-Integration-Api-Key: <your RM API key>' \
  -H 'Content-Type: application/json' \
  -d '{
  "platform": "airbnb",
  "url": "https://www.airbnb.com/rooms/12345678"
}'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 200

All of the listing's links, including the one added.

Body (`application/json`): array of object `ota_link_response`

A page on another booking platform, or the listing's direct booking website, with every source that links the listing to it.

- `platform` (string, required, nullable, one of: `airbnb`, `booking_com`, `direct`, `vrbo`, `null`): The platform the page is on, as `PUT /listings/{listing_id}/ota_links` takes it. `null` only for the listing's own page on a channel that is none of these.
- `platform_name` (string, required, nullable): Display name of the platform, e.g. `Airbnb`, `Vrbo`, `Booking.com` or `Direct Website`.
- `external_id` (string, required, nullable): The platform's ID for the page, e.g. the Airbnb room ID. For a Booking.com page added by URL it is the country and slug from the URL (`US/cloud-nine`). For `direct`, the URL itself.
- `url` (string, required, nullable): The page's URL. `null` when no source gave one and Wheelhouse has no data for the page, e.g. a Booking.com hotel ID from the PMS.
- `title` (string, required, nullable): The page's title on that platform, or `null` when Wheelhouse has no data for the page.
- `own_listing` (boolean, required): `true` for the listing's own page on the channel it is connected through. It is listed even when no source links it, with an empty `sources`.
- `known` (boolean, required): Whether Wheelhouse has data for the page. A newly added page can take a while to become known. Always `true` for `direct`.
- `page_active` (boolean, required, nullable): Whether the page is still listed on the platform, or `null` when unknown.
- `sources` (array of object `ota_link_source`, required): Every source that links the listing to the page, oldest first.
  - Each item: One source that links the listing to the page.
  - `link_id` (integer, required, example: `48213`): Identifies this source's link. Pass it to `DELETE /listings/{listing_id}/ota_links/{link_id}`.
  - `source` (string, required, one of: `pms`, `user`, `bulk`): `pms` when the listing's PMS sent the link, `user` when a user added it in Wheelhouse or through this API, `bulk` when it came from a bulk upload.
  - `since` (string (date-time), required): When this source first linked the page.
  - `removable` (boolean, required): Whether `DELETE /listings/{listing_id}/ota_links/{link_id}` can remove this source's link. Links from the PMS cannot be removed.

Example shape (generated from the schema; placeholder values, not a real response):

```json
[
  {
    "platform": "airbnb",
    "platform_name": "string",
    "external_id": "string",
    "url": "string",
    "title": "string",
    "own_listing": true,
    "known": true,
    "page_active": true,
    "sources": [
      {
        "link_id": 48213,
        "source": "pms",
        "since": "2026-01-01T00:00:00Z",
        "removable": true
      }
    ]
  }
]
```

### 400

`platform` or `url` is missing, or `platform` is not one of the listed values.

### 401

API key authorization failed.

### 403

Listing authorization failed (including a viewer on a shared listing), or the API key is read-only and may not be used with PUT.

### 404

Listing not found.

### 406

The listing is inactive. See the **Inactive Listings** section in the overview.

Body (`application/json`): object

- `error` (string, example: `Listing '12345' is inactive`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "Listing '12345' is inactive"
}
```

### 422

The URL is not valid, or is not a listing page on the given platform.

### 429

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.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
