GUguesty
Channel Commission

Update or create listing level channel commission

Changed on

Replaces all listing-level channel commissions for the given listing.

Send an array of channel and source commission definitions. Each item requires channel and source; tax and commission are optional (same as POST/PATCH). If none exist yet, they are created. Any listing-level commissions missing from the body are removed (an empty array removes all listing-level commissions).

Unlike GET /unit-type/{unitTypeId} (which remaps a sub-unit ID to its parent before lookup), this PUT stores commissions under the unitTypeId you send — no parent remapping and no 400 for sub-units. Prefer the parent unit type ID so GET and PUT address the same listing-level commissions.

These commissions are used for reservations only when the listing levelEntityType is UNIT_TYPE (see GET/PUT unit-type/{unitTypeId}/level-configurations). When the level is ACCOUNT, account-level commissions are used instead.

put/channel-commissions-v2/unit-type/{unitTypeId}

Request

  • Base URL
    https://open-api.guesty.com/v1
  • URL
    https://open-api.guesty.com/v1/channel-commissions-v2/unit-type/{unitTypeId}
  • Auth
    API key in header authorization

Path parameters

unitTypeIdstring required
Example:df7hf01cnduhdb2125854dj8

Listing / unit type ID to store under (for example df7hf01cnduhdb2125854dj8). Not remapped to a parent (unlike GET on this path) and not rejected for sub-units. Prefer the parent unit type ID.

Request body

taxnumber

Tax percentage on the channel commission (0–100). Omit to save the entry without tax (same optional behavior as POST/PATCH create and update).

channelstring required

Booking channel name (for example bookingCom, airbnb2, homeaway2, or manual). Must form a valid pair with source: either manual (always allowed), or an active pair from the channel-commission configurations catalog. The Guesty Open API Valid Enumerations — Channel Commission Sources guide is a product overview of sources; acceptance here is the active catalog (invalid pairs return 400). The guide’s “Set Commission” column may disagree with the catalog for a given source.

sourcestring required

Booking source within the channel. Often the same as channel for direct channels; can differ for channel managers (for example channel rentalsUnited with source homeAway). Must form a valid pair with channel (see channel for the catalog rule).

isPreDeductboolean

When true, Guesty automatically deducts the channel commission from the host payout for reservations from this source (adds a negative host channel fee on the folio). This API only honors isPreDeduct for the manual channel — for any other channel the value is ignored and stored as false. The Valid Enumerations guide may list Pre-deduct for other sources (for example expedia) as a product/UI capability; that is not controlled by this field. Defaults to false when omitted.

Example request

[
  {
    "commission": {
      "value": 5,
      "of": [
        "ACCOMMODATION_FARE",
        "CLEANING_FEE",
        "LOCAL_TAX",
        "DAMAGE_WAIVER"
      ]
    },
    "tax": 3,
    "channel": "bookingCom",
    "source": "bookingCom"
  }
]

Response

The saved listing-level channel commissions. Each item in channels includes _id for use as channelCommissionId on PATCH and DELETE.

accountIdstring

Account ID that owns these channel commissions

unitTypeIdstring

Listing / unit type ID for listing-level commissions; omitted for account-level commissions

Example response

{
  "channels": [
    {
      "commission": {
        "value": 5,
        "of": [
          "ACCOMMODATION_FARE",
          "CLEANING_FEE",
          "LOCAL_TAX",
          "DAMAGE_WAIVER"
        ]
      },
      "tax": 3,
      "channel": "bookingCom",
      "source": "bookingCom",
      "_id": "5f3f7b2f5d7b9b001f6f6c9d"
    }
  ],
  "accountId": "df7hf01cnduhdb2125854dj8",
  "unitTypeId": "df7hf01cnduhdb2125854dj8"
}

Changes