Trigger a manual sync for a listing.
POST/listings/:listing_id/sync
Enqueues a price-posting job that pushes the latest Wheelhouse price recommendations to the connected channel and refreshes reservation data. Equivalent to clicking the Sync button in the Wheelhouse UI.
Plan requirement: Manual syncs are only available on paid (Pro) plans. Listings on
free or onboarding plans will receive 429 Too Many Requests.
Rate limit: The number of syncs allowed per day is determined by the listing's pricing
plan. Returns 429 Too Many Requests when the daily limit is exceeded.
Debounce: To prevent duplicate jobs from stacking up, if another sync for the same
listing was requested within the last 60 seconds, the endpoint returns 423 Locked.
Wait at least 60 seconds before retrying.
The request returns 202 Accepted immediately — the sync runs asynchronously in the
background. Use GET /listings/{listing_id}/pricing_tier or poll the Wheelhouse
dashboard to confirm when the sync has completed.
Request
Responses
- 202
- 401
- 403
- 404
- 423
- 429
Sync accepted and queued.
API key authorization failed.
Listing authorization failed (listing does not belong to the authenticated user, or the API key is read-only).
Listing not found.
A sync was already requested for this listing within the last 60 seconds. Retry after the debounce window has elapsed.
Daily sync limit reached for this listing, or the listing plan does not include manual syncs.