https://developers.bookingsync.com/changelog Stay up to date with the latest Smily API changes, features, and fixes. Thu, 06 Aug 2026 00:00:00 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed en Copyright 2026 Smily https://developers.bookingsync.com/changelog/2026/08/06/version-4-20-0 https://developers.bookingsync.com/changelog/2026/08/06/version-4-20-0 Thu, 06 Aug 2026 00:00:00 GMT

📚 Spell out the request paths in the Inbox Messaging guide. The guide referred to the "Inbox Conversations endpoints" and "Inbox Messages endpoints" by link only, so a reader who did not click through never saw a path and had to guess one — and /inbox_conversations guesses 404, because the resources are nested (/inbox/conversations, /inbox/messages, /inbox/participants). Each section now shows its path where the action is described. Also fixes the "Bookings endpoints" link under Fetching an Inbox Conversation, which pointed at the Applications reference page instead of Bookings.

]]> Improvements Documentation https://developers.bookingsync.com/changelog/2026/08/03/version-4-19-0 https://developers.bookingsync.com/changelog/2026/08/03/version-4-19-0 Mon, 03 Aug 2026 00:00:00 GMT

🔑 An Idempotency-Key is now scoped to the request that created it. Presenting a key alongside a different method, path or body returns 409 Conflict with the idempotency_key_mismatch code instead of replaying the unrelated first response. Retries of the identical request keep replaying as before.

📚 Document the header, which has been supported all along but was never written down. The new Idempotency section explains how to retry a write safely: the first response is stored and replayed to any later attempt at the same request, so a request that was applied but whose response never reached you is not applied twice. It also covers what is not stored (4xx and 5xx, so those retries genuinely re-run) and the one sharp edge — concurrent requests sharing a key are both processed. API best practices now recommends retrying 5xx with a backoff and a stable key instead of aborting the whole synchronization.

]]> Improvements Documentation https://developers.bookingsync.com/changelog/2026/07/30/version-4-18-0 https://developers.bookingsync.com/changelog/2026/07/30/version-4-18-0 Thu, 30 Jul 2026 00:00:00 GMT

📚 State the two things the Inbox Messaging guide left implicit. A new Prerequisites section lists the inbox_read / inbox_write scopes and the fact that Inbox Conversations for a Channel only exist once that Channel is connected to the Account — with no connection there is nothing to read and nothing to reply to. Flow now says up front that API messaging is reply-only: threads are opened on the Channel's side, and a Conversation you create yourself is not linked to a Channel's messaging system, so its Messages never reach the guest.

]]> Improvements Documentation https://developers.bookingsync.com/changelog/2026/07/29/version-4-16-0 https://developers.bookingsync.com/changelog/2026/07/29/version-4-16-0 Wed, 29 Jul 2026 00:00:00 GMT

📚 Correct how Claude's custom connectors (Cowork, claude.ai, Claude Desktop, mobile) connect to the MCP server: register the bare https://www.bookingsync.com/mcp URL with no query parameters, leave the OAuth client ID/secret empty, and paste the mcp_… token on the Connect to bookingsync-mcp sign-in page Smily opens — documented in Connecting clients with a screenshot of that page, and in Authentication → Connector sign-in. The pasted token is the credential — there is no separate connector password — so it keeps its own account scoping and expiry, and revoking it stops the connector too, which is why an expired token sends you back through the same page. The ?token= URL parameter is now marked legacy: still accepted, so existing setups keep working, but no longer the way to connect Claude. Troubleshooting covers the sign-in page appearing, a connector asking to reconnect, a rejected token, and Unregistered redirect_uri. (400).

]]> Improvements Documentation https://developers.bookingsync.com/changelog/2026/07/30/version-4-17-0 https://developers.bookingsync.com/changelog/2026/07/30/version-4-17-0 Wed, 29 Jul 2026 00:00:00 GMT

✨ Document the read-only Payouts and Channel Payouts resources, both in beta. /payouts exposes SmilyPay payouts — what Smily paid out and the Smily fees deducted on top of each collected payment, per booking, with each line's contribution to the payout total. /channel_payouts covers the step before it: what an OTA such as Airbnb or Booking.com actually wired, decomposed across each booking's commission, city tax, cleaning fees and deductions, plus account-level movements. Pivot between the two with related_channel_payout_references. Both require the new payouts_read scope.

📚 Add the Understanding payouts guide — a walkthrough for going from "the amount I received is not what I expected" to the line that explains it: which of the two endpoints owns each hop, a worked example, an ordered checklist of the five things that shrink a payout (Smily fee, carry-over from an earlier booking, channel deduction, account-level movement, the channel's own arithmetic), carry-over lines and their paired halves, direct bookings and split payment — including OTA bookings that also carry a SmilyPay upsell — and, explicitly, what you can verify independently and what you cannot.

⚠️ Note the beta caveats while these endpoints stabilise: /payouts returns one payout per page (per_page is capped at 1, since rows are computed on the fly), payment_gateway_id is required on every /payouts request and omitting it returns 400, and both resources are read-only — payouts are produced internally as OTA wires arrive.

]]> Features Documentation https://developers.bookingsync.com/changelog/2026/06/11/version-4-15-0 https://developers.bookingsync.com/changelog/2026/06/11/version-4-15-0 Thu, 11 Jun 2026 00:00:00 GMT

✨ Document the read-only Booking Cancelation Protection Summaries resource — the per-booking summary of cancelation-protection amounts (commissionable amount, eligible protection amount, rent revenue, policy, and churned_at) used for accounting reconciliation. Listing and fetching require the new bookings_cancelation_protection_read OAuth scope, which grants read access to this data.

]]> Features Documentation https://developers.bookingsync.com/changelog/2026/06/04/version-4-14-0 https://developers.bookingsync.com/changelog/2026/06/04/version-4-14-0 Thu, 04 Jun 2026 00:00:00 GMT

✨ Introduce the experimental MCP server — exposing API v3 over the Model Context Protocol so AI clients can query Smily resources directly. Covers authentication (header and URL tokens, single- and multi-account tokens with per-request account selection), the four tools, querying (filters, sparse fieldsets, pagination), the resource catalog, connecting clients (Claude Code, Claude Cowork, Codex), testing with MCP Inspector, and the JSON-RPC protocol.

]]> Features Documentation https://developers.bookingsync.com/changelog/2026/06/02/version-4-13-0 https://developers.bookingsync.com/changelog/2026/06/02/version-4-13-0 Tue, 02 Jun 2026 00:00:00 GMT

📚 Document the per-application connected-accounts cap on private applications. Private apps are limited to 5 connected accounts by default; new installations (both OAuth and private access code) are blocked once the cap is reached. Partners can contact partners@smily.com to formalize the partnership and lift the cap.

]]> Improvements Documentation https://developers.bookingsync.com/changelog/2026/05/27/version-4-12-0 https://developers.bookingsync.com/changelog/2026/05/27/version-4-12-0 Wed, 27 May 2026 00:00:00 GMT

✨ Expose payment_charge_commission on the Bookings endpoint — the Payment Charge commission amount — the commission charged by an OTA for processing payments (e.g. Payments by Booking.com). Available on the bookings_write_owned, bookings_read, and bookings_write scopes.

📚 Document the accuracy caveat: when the payout has not yet been reconciled from Booking.com via Smily Pay, the value may be off by approximately one cent — the real amount is only known once the payout is reconciled.

]]> Features Documentation https://developers.bookingsync.com/changelog/2026/05/13/version-4-10-0 https://developers.bookingsync.com/changelog/2026/05/13/version-4-10-0 Wed, 13 May 2026 00:00:00 GMT

📚 Document how the channel attribute on an Inbox Message controls relay to the originating platform (Airbnb, Booking.com, etc.) and how to derive the right value from the Conversation's default_channel. See the Inbox Messaging guide.

]]> Improvements Documentation https://developers.bookingsync.com/changelog/2026/05/13/version-4-11-0 https://developers.bookingsync.com/changelog/2026/05/13/version-4-11-0 Wed, 13 May 2026 00:00:00 GMT

📚 Document that start_at and end_at on Create a new booking must be full datetimes whose time-of-day matches the rental's checkin_time / checkout_time. Date-only values get coerced to midnight and trip the "is within a used period" validation against adjacent bookings. The booking-creation example payloads now use full datetimes instead of START_AT / END_AT placeholders.

]]> Improvements Documentation https://developers.bookingsync.com/changelog/2026/05/07/version-4-9-0 https://developers.bookingsync.com/changelog/2026/05/07/version-4-9-0 Thu, 07 May 2026 00:00:00 GMT

✨ Expose start_at_global and end_at_global on the Booking resource. These are the booking's check-in and check-out as true UTC instants (rental's timezone applied), suitable for absolute time-window comparisons. The existing start_at and end_at remain wall-clock values in the rental's local timezone.

]]> Features https://developers.bookingsync.com/changelog/2026/05/06/version-4-8-0 https://developers.bookingsync.com/changelog/2026/05/06/version-4-8-0 Wed, 06 May 2026 00:00:00 GMT

🐞 Webhook deliveries now respect each application's per-account rental exposure (whitelist / blacklist) configuration, mirroring the visibility of GET /rentals. Rental-scoped events (booking_*, inquiry_*, photo_*, payment_*, review_*, etc.) are only delivered for rentals exposed to the receiving application. See Webhook subscriptions → Rental access scope.

]]> Bug Fixes https://developers.bookingsync.com/changelog/2026/05/04/version-4-7-0 https://developers.bookingsync.com/changelog/2026/05/04/version-4-7-0 Mon, 04 May 2026 00:00:00 GMT

✨ Return Retry-After header on 429 rate limit responses, and clarify rate limiting scope (per OAuth application, no per-endpoint sub-limits).

]]> Features https://developers.bookingsync.com/changelog/2026/04/27/version-4-6-0 https://developers.bookingsync.com/changelog/2026/04/27/version-4-6-0 Mon, 27 Apr 2026 00:00:00 GMT

✨ Document the difference between map and map_with_price_variation on the Mid Term Rate Map endpoint, and how the per-day price modifier is resolved from Applications Periods Rentals and the Application's default_price_increase.

]]> Features https://developers.bookingsync.com/changelog/2026/04/14/version-4-5-0 https://developers.bookingsync.com/changelog/2026/04/14/version-4-5-0 Tue, 14 Apr 2026 00:00:00 GMT

✨ Document the application lock behavior when setting nightly_rates_managed_externally to true on a Rental: rates management is locked to the calling application, and a different application attempting to update the Nightly Rate Map will receive an explicit error.

]]> Features https://developers.bookingsync.com/changelog/2026/03/27/version-4-4-0 https://developers.bookingsync.com/changelog/2026/03/27/version-4-4-0 Fri, 27 Mar 2026 00:00:00 GMT

✨ Add new Booking Revenue Distributions endpoint (experimental).

]]> Features https://developers.bookingsync.com/changelog/2026/03/12/version-4-3-0 https://developers.bookingsync.com/changelog/2026/03/12/version-4-3-0 Thu, 12 Mar 2026 00:00:00 GMT

✨ Add classified_kind attribute to Bookings Fees and Bookings Taxes endpoints.

]]> Features https://developers.bookingsync.com/changelog/2025/12/10/version-4-2-0 https://developers.bookingsync.com/changelog/2025/12/10/version-4-2-0 Wed, 10 Dec 2025 00:00:00 GMT

✨ Add support for selectable adding/removing or bookings tags on a booking level..

]]> Features https://developers.bookingsync.com/changelog/2025/12/05/version-4-1-0 https://developers.bookingsync.com/changelog/2025/12/05/version-4-1-0 Fri, 05 Dec 2025 00:00:00 GMT

✨ Add support for task management.

]]> Features