Link a property to a listing
Link a property created by hand to a listing from your management software, switch to another listing, remove the connection, and keep the property's amenities up to date.
The video for this guide is coming soon.
A property linked to a listing receives its bookings by itself, and its photos when your management software provides them. Use this article to link a property created by hand, point it to another listing, or cut the link. Allow 3 minutes.
The property itself is created in Create a property by hand. Your management software is connected in Connect your management software.
Read the state of the connection
Step by step
- 1
Open the Properties menu.
- 2
On the property's row, click Property sheet.
- 3
Click the “Connection” tab. The “Linked listing” card tells you where the property stands.
| Row of the card | What it tells you |
|---|---|
| Listing name (API side) | The name of the listing in your management software |
| Linked number (platform side) | The identifier of the listing |
| API link | The connection that carries this listing |
| Link status | “Active” or “Off” |
| Last sync | The date of the last read, or “Never” |
A property without a listing shows “Created manually: this apartment is not linked to any listing. …”, followed by the button to link it. A linked property that also receives an iCal calendar shows a warning line: “This property also receives an iCal calendar: bookings may arrive twice. Remove the calendar in the iCal calendars card.”
Link a property created by hand
Step by step
- 1
Save the sheet first if you have changed it: otherwise, a window offers to discard your changes before linking.
- 2
In the “Linked listing” card, click Link to a listing. From the Properties menu, the “Link to a listing” button on the property's card leads to the same place.
- 3
Do several connections carry listings? A window asks “Which connection holds the listing for “…”?”: click the connection. With a single connection, this step is skipped: the list of listings opens directly, and “Change connection” brings back the list of connections.
- 4
The “Link apartments” window lists the listings: those that resemble the property, by name or address, come first. On the row of the right listing, click Link.
- 5
The “Link to a listing” window sums up what is going to happen. Click Confirm. The message “Apartment linked to the listing.” appears.
- When there is something to decide (a copy of this property that came through the import, or an old listing), the window keeps two pages: “Continue”, then “Confirm”.
Link the property to another listing
Do this when the listing has been recreated in your management software.
Step by step
- 1
In the “Linked listing” card, click Link to another API listing. The list of the connection's listings opens, with your property as a subtitle.
- 2
On the row of the new listing, click Link. The “Link to another listing” window opens.
- 3
Answer the choices offered, then click Continue.
- 4
Read the summary again and click Confirm. The message “Apartment linked to the new listing.” appears.
| Choice | What it does |
|---|---|
| Keep | Keeps the upcoming bookings from the old listing |
| Remove upcoming ones | Removes the upcoming bookings from the old listing from the calendar. If cleanings depend on them, the line “Their … cleanings will be cancelled at the next workflow run.” says so |
| Stop recreating the old listing on automatic import | The old listing is no longer recreated by the next imports. It stays visible in the connection's list of listings, with the “Ignored by the automatic import” badge; linking it by hand reopens it |
Nothing is changed on the external platform.
Remove the connection
Step by step
- 1
In the “Linked listing” card, click Remove the connection. The “Remove the connection?” window opens and says what is going to happen.
- 2
Click Remove. The message “Connection removed” appears.
| What the window says | What it means |
|---|---|
| Upcoming bookings for this apartment will be removed from the calendar. | The listing's upcoming stays disappear from the schedule |
| Past bookings and today's bookings are kept. | The history of stays remains |
| The listing's photos are removed from the sheet. | The photos that came from the software are no longer shown |
| The property and its history remain in the app. | Nothing is deleted |
| If you then link this apartment to another listing, only its upcoming bookings will be imported. | A new link does not bring back the past |
Settings › My company › History keeps a row for this removal.
Keep the amenities up to date
The amenities of a property are used by the checklists: a line based on an amenity appears only in the properties that have it. For a linked property, they can be taken from your management software.
Step by step
- 1
In the sheet, click the “Information” tab and scroll down to the “Amenities” card.
- 2
If the button is offered, click Refresh amenities to read again those from your management software.
- 3
To change them yourself, click Edit, then open “Choose amenities”.
- 4
Tick the amenities. For an amenity missing from the list, type its name and choose “Add “…””.
- 5
Correct “Bedrooms”, “Bathrooms”, “Capacity”, “Check-in” and “Check-out” if needed.
- 6
Click Save. The message “Amenities saved.” appears.
Frequently asked questions
Does removing the connection delete the property?
No. The property and its history stay in the app. Only the listing's upcoming bookings and its photos are removed.
Can a property that came through the custom source (API) be linked?
No. Your software finds it by its identifier at each send: it cannot be linked to a listing from another integration.
Can a property already linked to another software be linked?
Not directly. In the “Link apartments” window, it carries the mention “linked to …” and cannot be chosen. Remove its connection first from its sheet, then link it to the new listing.
Do the listing photos arrive straight away?
Not necessarily. When your software provides them, they appear in the sheet and are read again every night.
Does linking change anything in my management software?
No. Nothing is changed on the external platform.
Why does the “Linked listing” card mention an iCal calendar?
The property receives its bookings through the listing and through an iCal calendar: the same stays may arrive twice. Remove the calendar in the “iCal calendars” card of the same tab; the line disappears straight away.
How do I know whether my amenities come from the software or from me?
The “Amenities” card says so under its title: “From the management software” or “Entered manually”, with the date of the last fetch.