Webhook Listing Group

This documents the webhook payload that Host Tools will POST to your configured webhook URL when a listing group is added, changed or deleted.

Note: This is not an API endpoint you call.
This documents the requests that Host Tools sends TO your webhook URL.

When triggered:

  • listingGroup.created: a listing group is created
  • listingGroup.changed: a group's name, access code, owner import link or listings change. The payload has the group's full current listingIDs; compare it with your copy to see which listings joined or left. Several edits within 30 seconds are sent as one webhook with the latest data.
  • listingGroup.deleted: a listing group is deleted

Handling the webhook:

  1. Your endpoint should respond with HTTP 200 status
  2. Process the data asynchronously if needed
  3. Respond within 30 seconds
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Webhook payload sent by Host Tools

string
enum
required
Allowed:
string
enum
required
Allowed:
document
required

For listingGroup.created and listingGroup.changed, the listing group as /api/getListingGroup/{listingGroupID} returns it at the time of sending, with its full current listingIDs. For listingGroup.deleted, only _id and userID.

Response

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