API ReferenceCustomer APIMappings

Map listings under a parent listing

Maps (links) one or more child listings under a parent listing — parent-child mapping. Mapping groups the same physical property's listings across channels (for example its Airbnb and Vrbo listings) under one parent so they are managed and priced together. By default this only links the listings: nothing is copied from the parent, and children keep their own prices and settings. Use the optional `copy` flags to copy the parent's prices or settings to the children at map time. > **Warning:** `copy.customization` also deletes each child's future date-specific overrides and replaces them with the parent's.

Headers

X-API-KeystringRequired

Request

This endpoint expects an object.
parentobjectRequired
The listing that will be the parent. Must not itself be mapped as a child.
childrenlist of objectsRequired

Listings to map under the parent. Each must currently be unmapped (standalone); an already-mapped listing must be unmapped first. A child cannot be on the same PMS as the parent (unless same-PMS mapping is enabled for the account).

copyobjectOptional
What to copy from the parent to each child at map time. All default false.

Response

Listings mapped successfully
statusintegerOptional
successstringOptional

Errors

400
Bad Request Error
403
Forbidden Error