Enable sandbox distribution, authorize channels, map rooms or review imports.
Commands
price_adjustmentConfigure one existing room/channel nightly-price adjustment.
Success response: HTTP 200
Owner read/write key or owner session, property.manage and exact saved mapping required. Fixed amount: {type:"fixed",value:30} adds 30 listing-currency units per night. null removes the rate adjustment.
Updates only the existing native mapping price modifier. No remapping, disconnection, source-price publication or booking-rule reset. Configuration readback does not prove downstream price delivery. Unknown outcomes require verification, not blind retries.
{
"action": "price_adjustment",
"connectionId": "<connection-id>",
"roomId": "<room-id>",
"externalListingId": "<listing-id>",
"priceAdjustment": {
"type": "percentage",
"value": 20
}
}
{
"status": "configured",
"priceAdjustment": {
"type": "percentage",
"value": 20
},
"delivery": "pending"
}
verify_price_adjustmentVerify native adjustment and available downstream nightly prices.
Success response: HTTP 200
No provider writes. Can settle a lost configuration response locally. Uses actual source rates and channel calendar readback where supported; configured/unverified is returned when downstream readback is unavailable.
{
"action": "verify_price_adjustment",
"connectionId": "<connection-id>",
"roomId": "<room-id>",
"externalListingId": "<listing-id>"
}
{
"status": "verified",
"priceAdjustment": {
"type": "percentage",
"value": 20
},
"mismatches": 0,
"checkedAt": "<ISO timestamp>"
}
inventory_reviewReview full inventory for an isolated property.
Success response: HTTP 200
Preview only; checks local connections and upstream zero-channel scope. Saves an expiring proposal from normal room prices, rules and occupancy. No provider writes.
{
"action": "inventory_review"
}
{
"id": "<review-id>",
"days": 500,
"rooms": 1,
"availabilityCells": 500,
"rateCells": 500
}
inventory_publishPublish the explicitly reviewed full inventory.
Success response: HTTP 200
Rechecks isolation, current state and review fingerprint. Sends one combined rates/restrictions request and one availability request. Task acceptance is pending until authoritative provider readback. Unknown outcomes are not blindly replayed.
{
"action": "inventory_publish",
"reviewId": "<review-id>",
"reviewed": true
}
inventory_verifyVerify/recover authorized managed inventory.
Success response: HTTP 200
Pulls booking revisions before inventory recovery; can send definite rejected/retryable steps and subsequent saved deltas. Never a general read-only endpoint.
{
"action": "inventory_verify"
}
inventory_evidenceRead sanitized latest delivery receipts.
Success response: HTTP 200
No credentials or guest records. Includes per-step status, receipts and UTC update time; provider verification is not a claim of downstream OTA enforcement.
{
"action": "inventory_evidence"
}
{
"status": "pending",
"taskIds": [
"<task-id>"
],
"steps": []
}
enable_rate_syncOpt a listing/channel mapping into price-only deltas after verified owner publication.
Success response: HTTP 200
Rechecks current Airbnb price state and requires an existing published, verified baseline. Does not send restrictions or availability. Existing live properties are never opted in by deployment. Specify roomId and externalListingId together to scope consent to one mapping. Omit both only for the legacy whole-channel command. Shared source rates are rejected; sibling listings remain unchanged.
{
"action": "enable_rate_sync",
"connectionId": "<connection-id>",
"roomId": "<room-id>",
"externalListingId": "<listing-id>",
"reviewId": "<verified-publication-review-id>",
"reviewed": true
}
{
"status": "enabled",
"scope": "price-only"
}
enableAccept the currently reviewed terms and enable property channel management.
Success response: HTTP 200
Owner must review terms and the room-count estimate first. The API recomputes the estimate and stores it with consent; a mismatch is rejected. Creates/reuses provider property mapping and webhook. The latest term version comes from GET; do not hardcode it.
{
"action": "enable",
"plan": "hotel",
"termsVersion": "<plans.hotel.version from GET>",
"accepted": true,
"roomCount": 8,
"estimatedMonthlyPriceUsd": 18
}
{
"enabled": true,
"billing": "accepted"
}
connectStart channel authorization using the current catalog entry.
Success response: HTTP 200
Required settings depend on the catalog. Treat returned token/URL as sensitive; expire/cancel abandoned authorizations. Real authorization can reach real listings even in preview.
{
"action": "connect",
"code": "<catalog code>",
"redirectUrl": "https://your-app.example/channel-return"
}
{
"status": "authorization_required",
"url": "<owner-bound-authorization-url>"
}
completeComplete an owner-bound channel authorization.
Success response: HTTP 200
Use values from the authorization flow, not a room or listing ID. POST /api/channel-management/authorization is the callback orchestration endpoint.
{
"action": "complete",
"token": "<sensitive token>",
"channelId": "<authorization channelId>"
}
{
"connectionId": "<connection-id>"
}
cancel_authorizationCancel an uncompleted authorization without creating a connection.
Success response: HTTP 200
Only the initiating owner may cancel its current authorization session.
{
"action": "cancel_authorization",
"token": "<sensitive token>"
}
listingsRead authorized listings and their applicable mapping fields.
Success response: HTTP 200
Select listing/rate identifiers from this response. Do not invent or reuse IDs from another connection.
automaticPriceSync is the saved toggle intent. automaticPriceSyncStatus is enabled only when that mapping has active managed-price authorization; pending_review requires explicit publication review and needs_attention requires reconciliation. A checked toggle alone does not prove active delivery.
{
"action": "listings",
"connectionId": "<connection-id>"
}
{
"listings": [],
"mappingFields": []
}
mapMap one channel listing/rate to exactly one Wikiup room or classification.
Success response: HTTP 200
Use exactly one roomId or roomTypeId. A pooled classification provisions one provider room type with its sellable member count. A physical member cannot be independently mapped to another inventory bucket. Pooled absolute availability requires authoritative readback; unsupported live channel calendars stay pending review.
Optional priceAdjustment applies per room/channel during setup. Omit it to preserve upstream defaults; null explicitly means no rate adjustment. Field names and options come from listings.mappingFields. Review ownership and source identity before saving. Returns ok:true after saving the mapping; reload the workspace for current mappings.
{
"action": "map",
"connectionId": "<connection-id>",
"roomId": "<room-id>",
"externalListingId": "<listing-id>",
"settings": {
"<required mapping field>": "<selected value>"
},
"priceAdjustment": {
"type": "percentage",
"value": 20
}
}
booking_rules_reviewRead room/current/effective rules for saved mappings without publication.
Success response: HTTP 200
Each review includes room identity, property timezone, checkedAt, coverage, status and six rule rows, plus ruleSettings (room defaults, overrides, editability, stayOverridesSupported and synchronization status). Optional settings rows provide read-only Wikiup/channel values for capacity, pet policy/fees, availability, pricing coverage and local-only metadata. Each has setting, wikiup, channel and status (verified means observed match; enabled means configured sync, not verified delivery; disabled, review_required, unavailable and wikiup_only remain distinct). Opening a review never publishes these settings. Unavailable/unsupported values must remain visible, not be represented as defaults.
{
"action": "booking_rules_review",
"connectionId": "<connection-id>"
}
booking_rule_overridesSave per-listing/channel booking rules; omitted keys follow future room defaults.
Success response: HTTP 200
Replacement object, not a patch: send overrides:{} to return all supported rules to room defaults. Supported keys: minimumStay (1–365), maximumStay (1–1125), advanceNoticeHours (0–24,48,72,168), preparationDays (0–2), bookingWindowDays (30–365 in 30-day increments, plus 365).
Owner/property.manage required. Minimum cannot be below room floor; maximum must be at least effective minimum. Airbnb only; per-listing same-day cutoff is rejected because its provider scope is property-wide. Shared-source stay-limit overrides are rejected.
Save is explicit consent to replace supported base values for this mapping; initial setup still preserves preexisting restrictions. Pending/uncertain previous sends must settle before a different policy. Queued is saved for activation; pending is not verification.
{
"action": "booking_rule_overrides",
"connectionId": "<connection-id>",
"roomId": "<room-id>",
"externalListingId": "<listing-id>",
"overrides": {
"minimumStay": 3,
"advanceNoticeHours": 48
}
}
minimum_staySet a channel minimum without weakening the room floor.
Success response: HTTP 200
Integer 1–365, or null to use the room rule. Existing stricter channel baselines remain protected. Active channels may return pending/verified/needs_attention; queued is not delivery proof.
{
"action": "minimum_stay",
"connectionId": "<connection-id>",
"minimumStay": 3
}
activateActivate a reviewed connection and reconcile its cutover state.
Success response: HTTP 200
Requires saved mappings and reviewed rules. This can change upstream state; it is not a read or a certification prerequisite for Booking CRS.
{
"action": "activate",
"connectionId": "<connection-id>",
"reviewed": true,
"testListingAcknowledged": true
}
pauseClose this property’s Airbnb availability without pausing the shared account.
Success response: HTTP 200
Airbnb creates an open-ended property/channel close-out. Pending calendar verification is not paused. Retry Pause to verify; never deactivate the shared host. Other channels retain exclusive-account deactivation. Do not test against live listings.
{
"action": "pause",
"connectionId": "<connection-id>"
}
resumeRemove only Wikiup’s own property-specific Airbnb close-out.
Success response: HTTP 200
Explicit owner confirmation required. Does not write availability values, prices or booking rules. Configuration removal is verified; downstream calendar availability is not claimed as verified.
{
"action": "resume",
"connectionId": "<connection-id>",
"reviewed": true
}
removeRemove a channel connection through guarded teardown.
Success response: HTTP 200
Destructive upstream operation. Confirm scope and intent; uncertain teardown requires reconciliation rather than repeating blindly.
{
"action": "remove",
"connectionId": "<connection-id>"
}
syncRun property channel synchronization with current admission guards.
Success response: HTTP 200
The current reservationsOnly branch also checks automatic availability; it is not a guaranteed provider-read-only operation.
For isolated Booking CRS ingestion-only verification use sandbox-reservations action=verify instead. Default sync may process restrictions, listing settings and availability.
{
"action": "sync",
"reservationsOnly": true
}
{
"applied": 0,
"blocked": 0,
"complete": true
}
reviewRead the property-wide activation/publication review.
Success response: HTTP 200
Inspect actual blockers, issues, reservation coverage and proposedChanges. canApprove is not permission to auto-approve.
{
"status": "blocked",
"canApprove": false,
"blockers": [],
"nextActions": []
}
approvePublish only the explicitly owner-approved review.
Success response: HTTP 200
Property-wide scope: all participating active connections, not just the card last selected. Requires fresh reservation review and matching persisted review.
{
"action": "approve",
"reviewed": true,
"reviewId": "<publication-review-id>"
}
{
"status": "<publication-result>"
}
publishCompatibility alias for explicit reviewed publication.
Success response: HTTP 200
Same owner review requirements and upstream effects as approve. Never use as an automatic retry after an unknown send.
{
"action": "publish",
"reviewed": true,
"reviewId": "<publication-review-id>"
}
{
"status": "<publication-result>"
}
verify_publicationCheck the published review against provider readback.
Success response: HTTP 200
Possible results include not_verified/unavailable. This checks already reviewed publication but can reconcile booking restrictions; it is not a general read-only provider audit endpoint.
{
"action": "verify_publication",
"reviewId": "<publication-review-id>"
}
{
"status": "verified",
"reviewId": "<publication-review-id>",
"checkedAt": "<ISO timestamp>",
"mismatches": 0
}
enable_availability_syncExplicitly enable ongoing availability synchronization after verified setup.
Success response: HTTP 200
Requires current mappings and a verified published review. Enabling can pull bookings and send availability; do not enable it on a live listing for certification exercises.
{
"action": "enable_availability_sync",
"reviewId": "<verified publication-review-id>"
}
disable_rate_syncStop automatic price sends for the selected listing/channel mapping.
Success response: HTTP 200
Does not disconnect, change restrictions or erase pending receipts. In-flight/accepted writes cannot be recalled; any unsent stale batch is held.
{
"action": "disable_rate_sync",
"connectionId": "<connection-id>",
"roomId": "<room-id>",
"externalListingId": "<listing-id>"
}
{
"status": "disabled",
"connectionId": "<connection-id>"
}
preview_importRead content/coverage available for an authorized listing.
Success response: HTTP 200
Source history/content may be incomplete. This does not create an OTA listing or prove coverage.
{
"action": "preview_import",
"connectionId": "<connection-id>",
"externalListingId": "<listing-id>"
}
{
"importId": "<import-id>",
"status": "<import-status>"
}
importImport reviewed listing content as a Draft Wikiup room.
Success response: HTTP 200
capacity is an integer 1–100; nightlyRate is positive USD ≤100000. Room.name is internal; listingTitle is guest-facing. Resume copying until ready; do not assume complete history.
{
"action": "import",
"importId": "<import-id>",
"capacity": 2,
"nightlyRate": 137,
"name": "Internal unit",
"listingTitle": "Guest-facing listing title",
"reviewed": true
}
{
"roomId": "<room-id>",
"status": "<import-status>"
}
request_channelSubmit an authenticated request for channel availability.
Success response: HTTP 200
This submits a product request; it does not activate or authorize an external channel.
{
"action": "request_channel",
"name": "<requested channel name>",
"notes": "<optional context>"
}
{
"recorded": true,
"emailConfirmed": true,
"alreadyRequested": false
}