repull 0.2.33 → 0.2.35

data/openapi/v1.json

@@ -110,14 +110,14 @@
       "name": "VRBO",
       "description": "VRBO channel management \u2014 listings and reservations"
     },
-    {
-      "name": "Plumguide",
-      "description": "Plumguide channel management \u2014 availability, pricing, bookings"
-    },
     {
       "name": "AI",
       "description": "AI-powered operations \u2014 guest responses, intent classification, listing generation, pricing suggestions"
     },
+    {
+      "name": "Promotions",
+      "description": "Airbnb and Booking.com promotions on a listing, in one model: Airbnb\u2019s discount programmes (top-rated guests, mobile-only, new listing) and Booking.com deals, mobile and country rates and seasonal campaigns. Read the catalog first \u2014 it says, per channel, which types the listing can use and which fields each supports."
+    },
     {
       "name": "Pricing",
       "description": "Atlas-powered pricing recommendations and per-listing strategy. Recommendations are pre-computed by the Atlas pricing model from comp data, demand signals, and event calendars; this surface lets you read them, apply or decline them, and tune the strategy that constrains the model."
@@ -186,12 +186,17 @@
           "address": {
             "type": "string",
             "nullable": true,
-            "description": "Street address (from the listing's `street` field)."
+            "description": "Street line only, as stored on the listing \u2014 no unit, state or postal code. Kept for existing integrations; read `addressDetails` for the full postal address.",
+            "example": "2700 Northwest 2nd Avenue"
           },
           "city": {
             "type": "string",
             "nullable": true,
-            "example": "Miami Beach"
+            "description": "City as stored on the listing. Kept for existing integrations; `addressDetails.city` is the resolved city.",
+            "example": "Miami"
+          },
+          "addressDetails": {
+            "$ref": "#/components/schemas/PostalAddress"
           },
           "latitude": {
             "type": "string",
@@ -250,6 +255,55 @@
           }
         }
       },
+      "PostalAddress": {
+        "type": "object",
+        "description": "The full postal address, unit included. Returned on every active row of `GET /v1/properties`, `GET /v1/properties/{id}`, `GET /v1/listings` and `GET /v1/listings/{id}` (on listings, these fields sit inside `address`). Each part is read from the listing first, then from the connected channels (Airbnb, Vrbo, Booking.com), so `line2` carries the apartment or unit number that tells units in the same building apart. A part nobody has stored is `null`.",
+        "required": [
+          "line1",
+          "line2",
+          "city",
+          "state",
+          "postalCode",
+          "countryCode"
+        ],
+        "properties": {
+          "line1": {
+            "type": "string",
+            "nullable": true,
+            "description": "Street address: number and street.",
+            "example": "2700 Northwest 2nd Avenue"
+          },
+          "line2": {
+            "type": "string",
+            "nullable": true,
+            "description": "Apartment, unit, suite or building.",
+            "example": "Unit 241"
+          },
+          "city": {
+            "type": "string",
+            "nullable": true,
+            "example": "Miami"
+          },
+          "state": {
+            "type": "string",
+            "nullable": true,
+            "description": "State, province or region.",
+            "example": "FL"
+          },
+          "postalCode": {
+            "type": "string",
+            "nullable": true,
+            "description": "Postal or ZIP code.",
+            "example": "33127"
+          },
+          "countryCode": {
+            "type": "string",
+            "nullable": true,
+            "description": "ISO 3166-1 alpha-2 country code.",
+            "example": "US"
+          }
+        }
+      },
       "PropertyAvailabilityDay": {
         "type": "object",
         "description": "One calendar day in the availability window.",
@@ -448,6 +502,10 @@
             "type": "number",
             "description": "VAT charged on top of this line, when the channel splits it out separately.",
             "example": 0
+          },
+          "promotionType": {
+            "type": "string",
+            "description": "Discount lines only: the listing promotion that produced the discount, named as in `GET /v1/listings/{id}/promotions` (Airbnb reports each applied promotion as its own line). `custom` is an Airbnb Custom promotion."
           }
         }
       },
@@ -1286,6 +1344,15 @@
           "direction": {
             "type": "string"
           },
+          "status": {
+            "type": "string",
+            "description": "Delivery state. Inbound messages are `received`. An outbound message is `sending` while it is queued to the channel, `sent` once the channel accepted it, or `failed`. Only `sent` (or `received`) means the guest can see it."
+          },
+          "statusReason": {
+            "type": "string",
+            "nullable": true,
+            "description": "Why a message is still `sending` or `failed`, in plain words. `null` otherwise."
+          },
           "senderType": {
             "type": "string",
             "nullable": true,
@@ -1334,7 +1401,9 @@
           },
           "deliveredAt": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "nullable": true,
+            "description": "When the message reached the channel. `null` while it is `sending` or when it `failed`."
           },
           "readAt": {
             "type": "string",
@@ -2238,6 +2307,11 @@
                   ],
                   "description": "Vrbo only."
                 },
+                "notificationEmail": {
+                  "type": "string",
+                  "nullable": true,
+                  "description": "Vrbo only. The address the host can add on Vrbo as a secondary email (with message and reservation notifications on) so new bookings, inquiries and messages arrive within a minute instead of at the scheduled check. Ask every host to add it: notifications are how Vrbo updates reach Repull, the scheduled check is the backup. Hosted Connect shows it on its mapping screen; show it in your own app when you create sessions with `mapping: \"api\"`."
+                },
                 "import": {
                   "nullable": true,
                   "allOf": [
@@ -2682,7 +2756,6 @@
           "listing.deleted",
           "listing.suspended",
           "listing.reactivated",
-          "calendar.updated",
           "account.created",
           "connect.session.completed",
           "account.disconnected",
@@ -3646,7 +3719,7 @@
       },
       "ListingUpdatedPayload": {
         "type": "object",
-        "description": "Payload for `listing.updated`. Something about the listing changed on the channel \u2014 content, pricing, booking settings, house rules, availability or sync settings.",
+        "description": "Payload for `listing.updated`. Something about the listing changed on the channel \u2014 content, pricing, booking settings, house rules, availability, sync settings or promotions.",
         "required": [
           "object"
         ],
@@ -3656,7 +3729,7 @@
           },
           "area": {
             "type": "string",
-            "description": "Which part moved. Airbnb sends one notification per area rather than a diff, so this is the signal for what to re-read.",
+            "description": "Which part moved. Airbnb sends one notification per area rather than a diff, so this is the signal for what to re-read. `promotions`: the listing\u2019s Airbnb or Booking.com promotions changed \u2014 re-read `GET /v1/listings/{id}/promotions`.",
             "example": "content"
           },
           "previousAttributes": {
@@ -3716,43 +3789,6 @@
           }
         }
       },
-      "CalendarUpdatedPayload": {
-        "type": "object",
-        "description": "Payload for `calendar.updated`. Availability or pricing for a listing was updated.",
-        "properties": {
-          "listingId": {
-            "type": "integer",
-            "example": 6250
-          },
-          "range": {
-            "type": "object",
-            "properties": {
-              "start": {
-                "type": "string",
-                "format": "date",
-                "example": "2026-06-01"
-              },
-              "end": {
-                "type": "string",
-                "format": "date",
-                "example": "2026-06-15"
-              }
-            }
-          },
-          "affectedDates": {
-            "type": "integer",
-            "example": 14
-          },
-          "pricingChanged": {
-            "type": "boolean",
-            "example": true
-          },
-          "availabilityChanged": {
-            "type": "boolean",
-            "example": false
-          }
-        }
-      },
       "AccountCreatedPayload": {
         "type": "object",
         "description": "Payload for `account.created`. An OAuth or API credential connection was completed by an end user.",
@@ -3799,7 +3835,7 @@
           "provider": {
             "type": "string",
             "nullable": true,
-            "description": "Channel or PMS: airbnb, booking, booking_extranet, vrbo, plumguide, hostaway, \u2026",
+            "description": "Channel or PMS: airbnb, booking, booking_extranet, vrbo, hostaway, \u2026",
             "example": "vrbo"
           },
           "externalAccountId": {
@@ -4834,42 +4870,6 @@
           }
         }
       },
-      "CalendarUpdatedEvent": {
-        "type": "object",
-        "required": [
-          "event",
-          "eventId",
-          "apiVersion",
-          "timestamp",
-          "data"
-        ],
-        "properties": {
-          "event": {
-            "type": "string",
-            "description": "The event name. This field is `event`, not `type`."
-          },
-          "eventId": {
-            "type": "string",
-            "format": "uuid",
-            "description": "Stable across every delivery and replay of this logical event \u2014 dedupe on it."
-          },
-          "apiVersion": {
-            "type": "string",
-            "example": "2026-04"
-          },
-          "timestamp": {
-            "type": "string",
-            "format": "date-time",
-            "description": "When this delivery was built."
-          },
-          "account": {
-            "$ref": "#/components/schemas/WebhookEventAccount"
-          },
-          "data": {
-            "$ref": "#/components/schemas/CalendarUpdatedPayload"
-          }
-        }
-      },
       "AccountCreatedEvent": {
         "type": "object",
         "required": [
@@ -5762,9 +5762,6 @@
           {
             "$ref": "#/components/schemas/ListingReactivatedEvent"
           },
-          {
-            "$ref": "#/components/schemas/CalendarUpdatedEvent"
-          },
           {
             "$ref": "#/components/schemas/AccountCreatedEvent"
           },
@@ -5837,7 +5834,6 @@
             "listing.deleted": "#/components/schemas/ListingDeletedEvent",
             "listing.suspended": "#/components/schemas/ListingSuspendedEvent",
             "listing.reactivated": "#/components/schemas/ListingReactivatedEvent",
-            "calendar.updated": "#/components/schemas/CalendarUpdatedEvent",
             "account.created": "#/components/schemas/AccountCreatedEvent",
             "connect.session.completed": "#/components/schemas/ConnectSessionCompletedEvent",
             "account.disconnected": "#/components/schemas/AccountDisconnectedEvent",
@@ -6152,22 +6148,6 @@
           }
         }
       },
-      "PlumguideListing": {
-        "type": "object",
-        "description": "A Plumguide listing.",
-        "properties": {
-          "id": {
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          },
-          "status": {
-            "type": "string",
-            "nullable": true
-          }
-        }
-      },
       "AirbnbReservation": {
         "type": "object",
         "description": "An Airbnb reservation as returned by the channel API. Use `confirmationCode` to address it in Airbnb operations.",
@@ -7031,8 +7011,7 @@
                 "example": [
                   "airbnb",
                   "booking",
-                  "vrbo",
-                  "plumguide"
+                  "vrbo"
                 ]
               },
               "validParams": {
@@ -8000,20 +7979,6 @@
           }
         }
       },
-      "PlumguideListingListResponse": {
-        "type": "object",
-        "properties": {
-          "data": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/PlumguideListing"
-            }
-          },
-          "pagination": {
-            "$ref": "#/components/schemas/Pagination"
-          }
-        }
-      },
       "ListingCreateRequest": {
         "type": "object",
         "required": [
@@ -9549,14 +9514,48 @@
           },
           "address": {
             "type": "object",
+            "description": "The listing's postal address, unit included. Each part is read from the listing first, then from the connected channels (Airbnb, Vrbo, Booking.com). On an inactive row only `city` is present.",
             "properties": {
               "street": {
                 "type": "string",
-                "nullable": true
+                "nullable": true,
+                "description": "Street line as stored on the listing. Kept for existing integrations; same value as `line1` unless the listing has no street of its own.",
+                "example": "2700 Northwest 2nd Avenue"
+              },
+              "line1": {
+                "type": "string",
+                "nullable": true,
+                "description": "Street address: number and street.",
+                "example": "2700 Northwest 2nd Avenue"
+              },
+              "line2": {
+                "type": "string",
+                "nullable": true,
+                "description": "Apartment, unit, suite or building.",
+                "example": "Unit 241"
               },
               "city": {
                 "type": "string",
-                "nullable": true
+                "nullable": true,
+                "example": "Miami"
+              },
+              "state": {
+                "type": "string",
+                "nullable": true,
+                "description": "State, province or region.",
+                "example": "FL"
+              },
+              "postalCode": {
+                "type": "string",
+                "nullable": true,
+                "description": "Postal or ZIP code.",
+                "example": "33127"
+              },
+              "countryCode": {
+                "type": "string",
+                "nullable": true,
+                "description": "ISO 3166-1 alpha-2 country code.",
+                "example": "US"
               }
             }
           },
@@ -9692,6 +9691,624 @@
           }
         }
       },
+      "Promotion": {
+        "type": "object",
+        "description": "One promotion on one listing. Airbnb sets the discount for its promotions (`discount.setBy: channel`); Booking.com promotions belong to the property and list the rooms they cover in `appliesTo`.",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Repull id of this promotion on this listing (use it in `/promotions/{promotionId}`)."
+          },
+          "listingId": {
+            "type": "string"
+          },
+          "channel": {
+            "type": "string"
+          },
+          "type": {
+            "$ref": "#/components/schemas/PromotionType"
+          },
+          "channelType": {
+            "type": "string",
+            "description": "The channel\u2019s own name, e.g. `HIGH_RATED_GUEST_DISCOUNT`, `basic`, `campaign_getaway`."
+          },
+          "externalId": {
+            "type": "string",
+            "description": "The channel\u2019s promotion id. Booking.com may issue a new one when a promotion is changed; the Repull `id` stays the same."
+          },
+          "channelPropertyId": {
+            "type": "string",
+            "description": "Airbnb listing id, or the Booking.com property (hotel id) the promotion belongs to."
+          },
+          "name": {
+            "type": "string",
+            "nullable": true
+          },
+          "status": {
+            "type": "string",
+            "description": "`eligible`: the listing qualifies but is not enrolled (Airbnb new listing promotion). `inactive`: switched off; Booking.com keeps deactivated promotions."
+          },
+          "managedBy": {
+            "type": "string",
+            "description": "`channel`: created in the channel\u2019s own tools and read-only here (Airbnb Custom promotions)."
+          },
+          "managedKey": {
+            "type": "string",
+            "nullable": true,
+            "description": "Set when it comes from the listing\u2019s weekly or monthly discount in its pricing settings \u2014 change those instead."
+          },
+          "editable": {
+            "type": "boolean"
+          },
+          "removable": {
+            "type": "boolean"
+          },
+          "discount": {
+            "type": "object",
+            "properties": {
+              "percent": {
+                "type": "number",
+                "nullable": true
+              },
+              "setBy": {
+                "type": "string",
+                "enum": [
+                  "host",
+                  "channel"
+                ]
+              }
+            }
+          },
+          "rules": {
+            "$ref": "#/components/schemas/PromotionRules"
+          },
+          "appliesTo": {
+            "type": "object",
+            "nullable": true,
+            "description": "Booking.com only. An empty `rooms` list means every room on the property.",
+            "properties": {
+              "rooms": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "ratePlans": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "usage": {
+            "type": "object",
+            "nullable": true,
+            "properties": {
+              "bookings": {
+                "type": "integer"
+              },
+              "roomNights": {
+                "type": "integer"
+              },
+              "cancellations": {
+                "type": "integer"
+              },
+              "revenue": {
+                "type": "object",
+                "properties": {
+                  "amount": {
+                    "type": "number"
+                  },
+                  "currency": {
+                    "type": "string"
+                  }
+                }
+              },
+              "lastAppliedAt": {
+                "type": "string",
+                "format": "date-time",
+                "description": "Airbnb Custom promotion: when it was last applied to a booking."
+              },
+              "lastAppliedAmount": {
+                "type": "object",
+                "properties": {
+                  "amount": {
+                    "type": "number"
+                  },
+                  "currency": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          },
+          "expiresAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "syncedAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "PromotionType": {
+        "type": "string",
+        "enum": [
+          "new_listing",
+          "mobile",
+          "top_rated_guests",
+          "deal",
+          "last_minute",
+          "early_booker",
+          "country",
+          "campaign",
+          "custom"
+        ],
+        "description": "The same idea on both channels shares a type: `mobile` is Airbnb\u2019s mobile-only discount or Booking.com\u2019s mobile rate; `new_listing` is Airbnb\u2019s new listing promotion or Booking.com\u2019s new property deal. `top_rated_guests` is Airbnb only; the deal, last-minute, early-booker, country and campaign types are Booking.com only; `custom` (Airbnb Custom promotion) is read-only."
+      },
+      "PromotionRules": {
+        "type": "object",
+        "description": "Which rules a type supports depends on the channel \u2014 see the catalog.",
+        "properties": {
+          "campaign": {
+            "type": "string",
+            "description": "Booking.com campaigns: `black_friday`, `getaway`, `late_escape`, `early_year`."
+          },
+          "audience": {
+            "type": "string",
+            "description": "`public`, `subscribers` (members only, at least 10%), `app`, `all` (app and mobile web), or a country id from the catalog (e.g. `united_kingdom_pos`)."
+          },
+          "stayWindow": {
+            "type": "object",
+            "properties": {
+              "start": {
+                "type": "string",
+                "format": "date"
+              },
+              "end": {
+                "type": "string",
+                "format": "date"
+              },
+              "weekdays": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "mon",
+                    "tue",
+                    "wed",
+                    "thu",
+                    "fri",
+                    "sat",
+                    "sun"
+                  ]
+                }
+              },
+              "excludedDates": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "format": "date"
+                }
+              },
+              "additionalDates": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "format": "date"
+                }
+              }
+            }
+          },
+          "bookingWindow": {
+            "type": "object",
+            "properties": {
+              "start": {
+                "type": "string",
+                "format": "date"
+              },
+              "end": {
+                "type": "string",
+                "format": "date"
+              },
+              "startHour": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 23
+              },
+              "endHour": {
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 23
+              }
+            }
+          },
+          "lastMinute": {
+            "type": "object",
+            "properties": {
+              "unit": {
+                "type": "string",
+                "enum": [
+                  "day",
+                  "hour"
+                ]
+              },
+              "value": {
+                "type": "integer",
+                "minimum": 1,
+                "maximum": 1000
+              }
+            }
+          },
+          "earlyBookerDays": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 500
+          },
+          "minNights": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 30
+          },
+          "nonRefundable": {
+            "type": "boolean"
+          },
+          "blackoutDates": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "date"
+            },
+            "description": "Airbnb \u2014 not yet available."
+          },
+          "blackoutDatesQuota": {
+            "type": "object",
+            "properties": {
+              "used": {
+                "type": "integer"
+              },
+              "available": {
+                "type": "integer"
+              }
+            }
+          }
+        }
+      },
+      "PromotionInput": {
+        "type": "object",
+        "required": [
+          "channel",
+          "type"
+        ],
+        "properties": {
+          "channel": {
+            "type": "string"
+          },
+          "type": {
+            "$ref": "#/components/schemas/PromotionType"
+          },
+          "name": {
+            "type": "string",
+            "description": "Booking.com only; only you see it."
+          },
+          "discountPercent": {
+            "type": "integer",
+            "description": "Booking.com only \u2014 Airbnb sets its own rates. Limits per type are in the catalog."
+          },
+          "rules": {
+            "$ref": "#/components/schemas/PromotionRules"
+          }
+        }
+      },
+      "PromotionCreateRequest": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/PromotionInput"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "hotelId": {
+                "type": "string",
+                "description": "Booking.com: required when the listing has a room on more than one property (see `properties` in the catalog)."
+              }
+            }
+          }
+        ]
+      },
+      "PromotionUpdateRequest": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "discountPercent": {
+            "type": "integer"
+          },
+          "rules": {
+            "$ref": "#/components/schemas/PromotionRules"
+          },
+          "confirmShared": {
+            "type": "boolean",
+            "description": "Required when the promotion also covers other listings\u2019 rooms \u2014 the change applies to them too."
+          }
+        }
+      },
+      "PromotionCatalogField": {
+        "type": "object",
+        "properties": {
+          "supported": {
+            "type": "boolean"
+          },
+          "comingSoon": {
+            "type": "boolean",
+            "description": "Shown but not yet usable on this channel."
+          },
+          "required": {
+            "type": "boolean"
+          },
+          "min": {
+            "type": "number"
+          },
+          "max": {
+            "type": "number"
+          },
+          "fixed": {
+            "type": "number",
+            "description": "Value the channel sets (e.g. Airbnb\u2019s 15% top-rated-guests discount)."
+          },
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "label": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        }
+      },
+      "PromotionCatalogEntry": {
+        "type": "object",
+        "properties": {
+          "channel": {
+            "type": "string"
+          },
+          "type": {
+            "$ref": "#/components/schemas/PromotionType"
+          },
+          "channelType": {
+            "type": "string"
+          },
+          "campaign": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string",
+            "description": "One or two sentences to show hosts."
+          },
+          "isNew": {
+            "type": "boolean",
+            "description": "Newly available \u2014 show a \u201cNew\u201d badge."
+          },
+          "available": {
+            "type": "boolean"
+          },
+          "unavailableReason": {
+            "type": "string"
+          },
+          "single": {
+            "type": "boolean",
+            "description": "Only one at a time (Airbnb types; Booking.com mobile and country rates per property)."
+          },
+          "fields": {
+            "type": "object",
+            "description": "Every field, supported or not, so a UI can grey out what a type does not take.",
+            "additionalProperties": {
+              "$ref": "#/components/schemas/PromotionCatalogField"
+            }
+          }
+        }
+      },
+      "PromotionCatalog": {
+        "type": "object",
+        "properties": {
+          "listingId": {
+            "type": "string"
+          },
+          "channels": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "channel": {
+                  "type": "string",
+                  "enum": [
+                    "airbnb",
+                    "booking"
+                  ]
+                },
+                "connected": {
+                  "type": "boolean"
+                },
+                "reason": {
+                  "type": "string"
+                },
+                "properties": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  },
+                  "description": "Booking.com properties the listing has a room on."
+                },
+                "entries": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/PromotionCatalogEntry"
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "PromotionListResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Promotion"
+            }
+          },
+          "syncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "description": "When the channels were last read for this listing."
+          },
+          "syncError": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "PromotionResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/Promotion"
+          }
+        }
+      },
+      "PromotionDeleteResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "removed": {
+                "type": "boolean"
+              },
+              "promotionId": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      },
+      "PromotionCatalogResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/PromotionCatalog"
+          }
+        }
+      },
+      "PromotionRefreshResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Promotion"
+            }
+          },
+          "syncedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "errors": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "PromotionBulkRequest": {
+        "type": "object",
+        "required": [
+          "listingIds",
+          "action",
+          "promotion"
+        ],
+        "properties": {
+          "listingIds": {
+            "type": "array",
+            "items": {
+              "type": "integer"
+            },
+            "minItems": 1,
+            "maxItems": 100
+          },
+          "action": {
+            "type": "string"
+          },
+          "promotion": {
+            "$ref": "#/components/schemas/PromotionInput"
+          }
+        }
+      },
+      "PromotionBulkResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "listingId": {
+                  "type": "string"
+                },
+                "ok": {
+                  "type": "boolean"
+                },
+                "promotion": {
+                  "$ref": "#/components/schemas/Promotion"
+                },
+                "error": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "field": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "summary": {
+            "type": "object",
+            "properties": {
+              "succeeded": {
+                "type": "integer"
+              },
+              "failed": {
+                "type": "integer"
+              }
+            }
+          }
+        }
+      },
       "ListingPricingResponse": {
         "type": "object",
         "properties": {
@@ -17653,6 +18270,15 @@
                     "example": 24,
                     "description": "Airbnb \u2014 how many months of past reservations the first import pulls (1\u201360). Omit it for the default window. Upcoming stays are always imported. A wider window takes longer to import, because every extra month is more stays to fetch."
                   },
+                  "mapping": {
+                    "type": "string",
+                    "enum": [
+                      "hosted",
+                      "api"
+                    ],
+                    "default": "hosted",
+                    "description": "Where the channel's units get linked to listings. `hosted` (default): after a Vrbo or Booking.com Extranet sign-in, Connect shows a mapping step and returns to `redirectUrl` when it's confirmed. `api`: Connect skips that step and finishes right after sign-in. The connection reaches you in the `connect.session.completed` webhook (and as `connectionId` in the popup message), its handle is `vrbo:{connectionId}` or `booking_extranet:{connectionId}`; you list the units with `GET /v1/connections/{id}/units` and link them with `POST /v1/connections/{id}/mappings`. Nothing is imported until you post the mappings. Other providers ignore it."
+                  },
                   "accessType": {
                     "type": "string",
                     "enum": [
@@ -17891,7 +18517,7 @@
       "post": {
         "operationId": "create_connection",
         "summary": "Connect to PMS/OTA provider",
-        "description": "Establish a connection to a PMS or OTA platform. Credentials vary by provider \u2014 see docs for each provider.\n\nAirbnb-specific: pass `redirectUrl` (where to send the user after consent) and optionally `accessType`. Three tiers: `read_only` grants read-only scopes; `messaging` grants read scopes plus message read/send but NOT property management, so it can coexist with another app (e.g. an existing PMS) that already holds property management on the same Airbnb account; `full_access` \u2014 the default \u2014 grants full host scopes including the exclusive property management (only one app per Airbnb account can hold it). The response returns a hosted `url` to redirect the user to.\n\nBooking.com: pass `redirectUrl` (no `accessType`). The response returns a hosted `url` \u2014 send the user there to designate FantasticStay in their Booking.com Extranet and paste their Hotel ID. Same response shape as Airbnb (`url`, `sessionId`, `expiresAt`).\n\nPlumguide passes `clientId`/`clientSecret`. PMS providers are not connected by this call: send their credentials to `POST /v1/connect/{provider}/credentials`, or start a hosted session with `POST /v1/connect`.",
+        "description": "Establish a connection to a PMS or OTA platform. Credentials vary by provider \u2014 see docs for each provider.\n\nAirbnb-specific: pass `redirectUrl` (where to send the user after consent) and optionally `accessType`. Three tiers: `read_only` grants read-only scopes; `messaging` (shown to hosts as \"Messaging & reviews\") grants read scopes plus message read/send and review writes (reply to guest reviews, submit host reviews \u2014 Airbnb's `reviews_write`) but NOT property management, so it can coexist with another app (e.g. an existing PMS) that already holds property management on the same Airbnb account; `full_access` \u2014 the default \u2014 grants full host scopes including the exclusive property management (only one app per Airbnb account can hold it). The response returns a hosted `url` to redirect the user to.\n\nBooking.com: pass `redirectUrl` (no `accessType`). The response returns a hosted `url` \u2014 send the user there to select our connectivity provider in their Booking.com Extranet and paste their Hotel ID. Same response shape as Airbnb (`url`, `sessionId`, `expiresAt`).\n\nPMS providers are not connected by this call: send their credentials to `POST /v1/connect/{provider}/credentials`, or start a hosted session with `POST /v1/connect`.",
         "tags": [
           "Connect"
         ],
@@ -17920,7 +18546,7 @@
                       "messaging"
                     ],
                     "default": "full_access",
-                    "description": "Airbnb only \u2014 selects the OAuth scope set. 'read_only' grants read-only scopes; 'messaging' grants read scopes plus message read/send but NOT property management, so it can coexist with another app (e.g. an existing PMS) that already holds property management on the same Airbnb account; 'full_access' (default) grants full host scopes including the exclusive property management (only one app per Airbnb account can hold it). The hosted consent screen normally lets the host pick a tier; passing `accessType` explicitly fixes the tier and hides that choice, so the host can only continue with the tier you requested. Omit it to let the host choose."
+                    "description": "Airbnb only \u2014 selects the OAuth scope set. 'read_only' grants read-only scopes; 'messaging' (shown to hosts as \"Messaging & reviews\") grants read scopes plus message read/send and review writes (reply to guest reviews, submit host reviews \u2014 Airbnb's reviews_write) but NOT property management, so it can coexist with another app (e.g. an existing PMS) that already holds property management on the same Airbnb account; 'full_access' (default) grants full host scopes including the exclusive property management (only one app per Airbnb account can hold it). The hosted consent screen normally lets the host pick a tier; passing `accessType` explicitly fixes the tier and hides that choice, so the host can only continue with the tier you requested. Omit it to let the host choose."
                   },
                   "reservationHistoryMonths": {
                     "type": "integer",
@@ -17933,14 +18559,6 @@
                     "type": "string",
                     "description": "Airbnb + Booking.com \u2014 your own correlation token, e.g. your user id (at most 500 characters). Echoed on the redirect back (`&state=`) and in the `connect.session.completed` webhook."
                   },
-                  "clientId": {
-                    "type": "string",
-                    "description": "Plumguide \u2014 client ID."
-                  },
-                  "clientSecret": {
-                    "type": "string",
-                    "description": "Plumguide \u2014 client secret."
-                  },
                   "locale": {
                     "type": "string",
                     "nullable": true,
@@ -18808,7 +19426,7 @@
       "get": {
         "operationId": "getChannelHealth",
         "summary": "Per-channel connectivity health",
-        "description": "Reports reachability and auth state for one channel (`airbnb`, `booking`, `vrbo`, `plumguide`). Use it to tell \"the channel is down\" apart from \"this workspace's connection expired\". `200` when `status` is `ok`, `503` when `degraded` or `down` (the body's `status` and `message` say which and why).\n\n**`vrbo`** reports the connector's own signals in a `vrbo` block: connected accounts, accounts VRBO signed out (their bookings, messages and calendar stop until reconnected \u2014 `down`), accounts whose inbox sync is late (`degraded`), and the calendar push queue backlog and its oldest wait (`degraded` past 3 hours). Its rate is calendar pushes VRBO refused over finished ones in the last 3 hours; failures inside Repull's own connector are reported apart as `vrbo.connector_errors` and do not count (`vrbo.window_hours`; `refresh_attempts_24h` / `refresh_rejections_24h` count that window for VRBO), judged only once at least 50 pushes finished and at least 5 failed \u2014 VRBO pushes run in bursts, so a day-long window would keep reporting a problem already fixed.",
+        "description": "Reports reachability and auth state for one channel (`airbnb`, `booking`, `vrbo`). Use it to tell \"the channel is down\" apart from \"this workspace's connection expired\". `200` when `status` is `ok`, `503` when `degraded` or `down` (the body's `status` and `message` say which and why).\n\n**`vrbo`** reports the connector's own signals in a `vrbo` block: connected accounts, accounts VRBO signed out (their bookings, messages and calendar stop until reconnected \u2014 `down`), accounts whose inbox sync is late (`degraded`), and the calendar push queue backlog and its oldest wait (`degraded` past 3 hours). Its rate is calendar pushes VRBO refused over finished ones in the last 3 hours; failures inside Repull's own connector are reported apart as `vrbo.connector_errors` and do not count (`vrbo.window_hours`; `refresh_attempts_24h` / `refresh_rejections_24h` count that window for VRBO), judged only once at least 50 pushes finished and at least 5 failed \u2014 VRBO pushes run in bursts, so a day-long window would keep reporting a problem already fixed.",
         "tags": [
           "Health"
         ],
@@ -18823,8 +19441,7 @@
               "enum": [
                 "airbnb",
                 "booking",
-                "vrbo",
-                "plumguide"
+                "vrbo"
               ]
             }
           }
@@ -19179,7 +19796,7 @@
       "post": {
         "operationId": "verifyBookingHotel",
         "summary": "Verify a Booking.com hotel ID for a Connect session",
-        "description": "Manual-paste fallback that closes the Booking.com claim flow. Call this after the customer completes Stage 1 designation in their Booking Extranet (ticking FantasticStay/Repull as their connectivity provider) and pastes their Hotel ID into the hosted picker.\n\nValidates the hotel against Booking's property API, persists the `pms_connections` row, kicks off the room import, and transitions the Connect session to `awaiting_room_mapping`.\n\nNo API key required \u2014 the `sessionId` is the capability token. Sessions in any terminal state are rejected.",
+        "description": "Manual-paste fallback that closes the Booking.com claim flow. Call this after the customer completes Stage 1 designation in their Booking Extranet (selecting our connectivity provider, named on the hosted Connect page) and pastes their Hotel ID into the hosted picker.\n\nValidates the hotel against Booking's property API, persists the `pms_connections` row, kicks off the room import, and transitions the Connect session to `awaiting_room_mapping`.\n\nNo API key required \u2014 the `sessionId` is the capability token. Sessions in any terminal state are rejected.",
         "tags": [
           "Connect"
         ],
@@ -26760,226 +27377,6 @@
         }
       }
     },
-    "/v1/channels/plumguide/listings": {
-      "get": {
-        "operationId": "list_plumguide_listings",
-        "summary": "List Plumguide listings",
-        "description": "List Plumguide listings this workspace has access to. Plumguide is approval-based \u2014 listings appear once Plumguide has accepted them.",
-        "tags": [
-          "Plumguide"
-        ],
-        "responses": {
-          "200": {
-            "description": "Listings",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/PlumguideListingListResponse"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/channels/plumguide/availability": {
-      "get": {
-        "operationId": "get_plumguide_availability",
-        "summary": "Get Plumguide availability",
-        "description": "Read the per-day availability calendar for a Plumguide listing. Returns the same row shape as Airbnb availability for SDK convenience.\n\nReturns `403 listing_inactive` when the listing this resolves to is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
-        "tags": [
-          "Plumguide"
-        ],
-        "responses": {
-          "200": {
-            "description": "Availability"
-          },
-          "403": {
-            "$ref": "#/components/responses/ListingInactive"
-          }
-        }
-      },
-      "put": {
-        "operationId": "update_plumguide_availability",
-        "summary": "Push availability to Plumguide",
-        "description": "Push per-day availability changes to Plumguide. Plumguide accepts only the next 24 months \u2014 dates beyond that are silently ignored.\n\nReturns `403 listing_inactive` when the listing this resolves to is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
-        "tags": [
-          "Plumguide"
-        ],
-        "responses": {
-          "200": {
-            "description": "Pushed"
-          },
-          "403": {
-            "$ref": "#/components/responses/ListingInactive"
-          }
-        }
-      }
-    },
-    "/v1/channels/plumguide/pricing": {
-      "get": {
-        "operationId": "get_plumguide_pricing",
-        "summary": "Get Plumguide pricing",
-        "description": "Read the current pricing for a Plumguide listing (base price, currency, weekend uplift).\n\nReturns `403 listing_inactive` when the listing this resolves to is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
-        "tags": [
-          "Plumguide"
-        ],
-        "responses": {
-          "200": {
-            "description": "Pricing"
-          },
-          "403": {
-            "$ref": "#/components/responses/ListingInactive"
-          }
-        }
-      },
-      "put": {
-        "operationId": "update_plumguide_pricing",
-        "summary": "Push pricing to Plumguide",
-        "description": "Push pricing changes to Plumguide. Plumguide rounds all prices to whole units of the listing currency \u2014 sub-unit precision is silently truncated.\n\nReturns `403 listing_inactive` when the listing this resolves to is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
-        "tags": [
-          "Plumguide"
-        ],
-        "responses": {
-          "200": {
-            "description": "Pushed"
-          },
-          "403": {
-            "$ref": "#/components/responses/ListingInactive"
-          }
-        }
-      }
-    },
-    "/v1/channels/plumguide/bookings": {
-      "get": {
-        "operationId": "list_plumguide_bookings",
-        "summary": "List Plumguide bookings",
-        "description": "List Plumguide bookings. Default returns all bookings; pass `listing_id` to filter to one listing, or `booking_code` to fetch a single booking.\n\nReturns `403 listing_inactive` when `listing_id` or `booking_code` resolves to an inactive listing. The unfiltered list is read straight from Plum Guide and is not filtered by listing status.",
-        "tags": [
-          "Plumguide"
-        ],
-        "parameters": [
-          {
-            "name": "listing_id",
-            "in": "query",
-            "required": false,
-            "schema": {
-              "type": "integer"
-            },
-            "description": "Filter to a single Plumguide listing."
-          },
-          {
-            "name": "booking_code",
-            "in": "query",
-            "required": false,
-            "schema": {
-              "type": "string"
-            },
-            "description": "Fetch a single booking by its Plumguide booking code."
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Bookings"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          },
-          "403": {
-            "$ref": "#/components/responses/ListingInactive"
-          },
-          "404": {
-            "$ref": "#/components/responses/NotFound"
-          },
-          "500": {
-            "$ref": "#/components/responses/InternalError"
-          }
-        }
-      }
-    },
-    "/v1/channels/plumguide/webhooks": {
-      "get": {
-        "operationId": "get_plumguide_webhooks",
-        "summary": "Get Plumguide webhook config",
-        "description": "Read the current Plumguide webhook configuration for this workspace.",
-        "tags": [
-          "Plumguide"
-        ],
-        "responses": {
-          "200": {
-            "description": "Webhook config"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          },
-          "404": {
-            "$ref": "#/components/responses/NotFound"
-          },
-          "500": {
-            "$ref": "#/components/responses/InternalError"
-          }
-        }
-      },
-      "put": {
-        "operationId": "update_plumguide_webhooks",
-        "summary": "Replace Plumguide webhook config",
-        "description": "Replace the Plumguide webhook configuration. The body carries the full webhook config payload \u2014 this is a full replacement, not a patch.",
-        "tags": [
-          "Plumguide"
-        ],
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "additionalProperties": true,
-                "description": "Full Plumguide webhook config payload."
-              }
-            }
-          }
-        },
-        "responses": {
-          "200": {
-            "description": "Updated"
-          },
-          "400": {
-            "$ref": "#/components/responses/BadRequest"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          },
-          "404": {
-            "$ref": "#/components/responses/NotFound"
-          },
-          "500": {
-            "$ref": "#/components/responses/InternalError"
-          }
-        }
-      },
-      "delete": {
-        "operationId": "delete_plumguide_webhooks",
-        "summary": "Remove Plumguide webhook config",
-        "description": "Delete the Plumguide webhook configuration for this workspace. Plumguide stops delivering webhooks until a new config is set.",
-        "tags": [
-          "Plumguide"
-        ],
-        "responses": {
-          "200": {
-            "description": "Deleted"
-          },
-          "401": {
-            "$ref": "#/components/responses/Unauthorized"
-          },
-          "404": {
-            "$ref": "#/components/responses/NotFound"
-          },
-          "500": {
-            "$ref": "#/components/responses/InternalError"
-          }
-        }
-      }
-    },
     "/v1/listings/{id}/pricing": {
       "get": {
         "operationId": "get_listing_pricing",
@@ -36472,6 +36869,11 @@
                         "completed"
                       ]
                     },
+                    "notification_email": {
+                      "type": "string",
+                      "nullable": true,
+                      "description": "Vrbo only. Ask the host to add this address on Vrbo as a secondary email, with message and reservation notifications on. It is how new bookings, inquiries and guest messages reach Repull within a minute; without it they arrive at the next scheduled check. Hosted Connect asks for it on its mapping screen, so show it in your own flow when you map with `mapping: \"api\"`."
+                    },
                     "units": {
                       "type": "array",
                       "items": {
@@ -36495,7 +36897,8 @@
                             "nullable": true
                           },
                           "meta": {
-                            "type": "object"
+                            "type": "object",
+                            "description": "Channel details that identify the unit. Booking.com Extranet: `hotel` (property name), `hotelId` (Booking.com property ID), `roomId` (Booking.com room ID), `city`. Vrbo: `headline`, `address`, `vrboStatus`; the Vrbo listing ID is `unit_id`."
                           }
                         }
                       }
@@ -38439,6 +38842,439 @@
           }
         }
       }
+    },
+    "/v1/listings/promotions/bulk": {
+      "post": {
+        "operationId": "bulk_listing_promotions",
+        "summary": "Add or remove a promotion on many listings",
+        "description": "Applies one promotion to up to 100 listings \u2014 `add` it, or `remove` the listing's running promotion of that channel and type. Each listing gets its own result with the channel's reason when refused, so one refusal doesn't stop the rest. Returns `403 listing_inactive` before doing anything when any listing is inactive.",
+        "tags": [
+          "Promotions"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PromotionBulkRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "A result per listing",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionBulkResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          }
+        }
+      }
+    },
+    "/v1/listings/{id}/promotions": {
+      "get": {
+        "operationId": "list_listing_promotions",
+        "summary": "List a listing's promotions",
+        "description": "Airbnb and Booking.com promotions on the listing, in one model. Includes Airbnb promotions running or available (the new listing promotion shows as `eligible` when the listing qualifies), Airbnb Custom promotions seen on bookings (read-only \u2014 they override your prices on Airbnb), and Booking.com promotions covering the listing's room, including deactivated ones.\n\nPass `refresh=true` to re-read the channels first; otherwise the stored copy is returned (kept current by Airbnb's notifications and a sync every 30 minutes).\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          },
+          {
+            "name": "refresh",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean"
+            },
+            "description": "Re-read Airbnb and Booking.com before answering."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The listing's promotions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionListResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      },
+      "post": {
+        "operationId": "create_listing_promotion",
+        "summary": "Add a promotion to a listing",
+        "description": "Adds an Airbnb or Booking.com promotion. Read `GET /v1/listings/{id}/promotions/catalog` first for the types and fields the listing's channels accept.\n\n**Airbnb:** send `channel` and `type` only (`top_rated_guests`, `mobile`, `new_listing`) \u2014 Airbnb sets the discount. **Booking.com:** a listing's promotion covers that listing's room; send `discountPercent` and the rules the type takes, and `hotelId` when the listing is on several properties.\n\nA request a channel can't take is refused with `422` and a `promotion_*` code; the message names the channel and the field and says what to do, and `channel` / `field` are set. Booking.com writes return once Booking.com shows the change (it lags its own writes by a few seconds).\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PromotionCreateRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "The new promotion",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "502": {
+            "description": "The channel didn't answer"
+          }
+        }
+      }
+    },
+    "/v1/listings/{id}/promotions/catalog": {
+      "get": {
+        "operationId": "get_listing_promotion_catalog",
+        "summary": "Promotion types a listing can use",
+        "description": "Per channel: whether the listing is connected, and each promotion type with a short description for hosts, whether it is new, whether it is available to this listing (and why not), and every field \u2014 supported or not \u2014 with its limits and any value the channel fixes. Booking.com's types and limits come from the property itself; seasonal campaigns appear while Booking.com runs them.\n\nAirbnb asks partners to show newly available discounts with a \u201cNew\u201d badge and to grey out fields a discount does not support rather than hide them; `isNew` and `fields` carry what that needs.\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The catalog",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionCatalogResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      }
+    },
+    "/v1/listings/{id}/promotions/refresh": {
+      "post": {
+        "operationId": "refresh_listing_promotions",
+        "summary": "Re-read a listing's promotions now",
+        "description": "Reads the listing's promotions from Airbnb and Booking.com and returns them. Booking.com promotions belong to the property, so the property's other listings are refreshed too. `errors` lists any channel that could not be read.\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The listing's promotions after the read",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionRefreshResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      }
+    },
+    "/v1/listings/{id}/promotions/{promotionId}": {
+      "get": {
+        "operationId": "get_listing_promotion",
+        "summary": "Get one promotion",
+        "description": "One promotion on the listing.\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          },
+          {
+            "name": "promotionId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Promotion ID (from the list)"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The promotion",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        }
+      },
+      "patch": {
+        "operationId": "update_listing_promotion",
+        "summary": "Change a promotion",
+        "description": "Booking.com promotions only \u2014 Airbnb's have nothing to change. `rules`, when sent, replaces the promotion's rules whole. A promotion that also covers other listings' rooms changes for them too, so it needs `confirmShared: true` (otherwise `409 promotion_shared_promotion`). Promotions that come from the listing's weekly or monthly discount are changed in its pricing settings.\n\nA request a channel can't take is refused with `422` and a `promotion_*` code; the message names the channel and the field and says what to do, and `channel` / `field` are set. Booking.com writes return once Booking.com shows the change (it lags its own writes by a few seconds).\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          },
+          {
+            "name": "promotionId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Promotion ID (from the list)"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PromotionUpdateRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The changed promotion",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "502": {
+            "description": "The channel didn't answer"
+          }
+        }
+      },
+      "delete": {
+        "operationId": "delete_listing_promotion",
+        "summary": "Remove a promotion from a listing",
+        "description": "Airbnb: ends the listing's enrolment. Booking.com: takes the listing's room off the promotion \u2014 it keeps running for any other rooms it covers, and is deactivated when none are left. Airbnb Custom promotions can only be ended in Airbnb.\n\nA request a channel can't take is refused with `422` and a `promotion_*` code; the message names the channel and the field and says what to do, and `channel` / `field` are set. Booking.com writes return once Booking.com shows the change (it lags its own writes by a few seconds).\n\nReturns `403 listing_inactive` when the listing is inactive. An inactive listing keeps syncing, but cannot be read or changed through the API until it is activated.",
+        "tags": [
+          "Promotions"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Listing ID"
+          },
+          {
+            "name": "promotionId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Promotion ID (from the list)"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Removed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionDeleteResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/ListingInactive"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/Conflict"
+          },
+          "422": {
+            "$ref": "#/components/responses/UnprocessableEntity"
+          },
+          "502": {
+            "description": "The channel didn't answer"
+          }
+        }
+      }
     }
   }
 }