API Reference
Log In
API Reference

Create or Update Listing Group

post
https://app.hosttools.com/api/addListingGroup

Creates a new listing group, or updates an existing one when an _id
is provided in the body. Returns the saved group, including its
ownerImportLink (which is null until you call
/api/listingGroups/{id}/generateOwnerImportToken).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string

Provide to update an existing group; omit to create a new one.

string
required
listingIDs
array of strings

Listing _ids from GET /api/getListings. Every one must be a listing of this account; any other id is a 400 that names it in data.listingIDs.

listingIDs
string
length ≥ 20

Code for the public turnover link (/turnovers/{accessCode}), which needs no login. At least 20 characters; send an empty string to turn the link off.

Headers
string

Partner API key (deprecated — use OAuth 2.0 for new integrations)

string

User's authentication token (legacy). Use Authorization Bearer header for new integrations.

Responses

429

Too many requests

Updated 5 months ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago