Creates a message rule for one listing (listingID), the listings of one listing group (listingGroupID), or every listing (allListings: true). Send exactly one of the three. Every option of Host Tools' rule editor is available. Requires the messageRules:write scope.
Each event takes its own options (see the request body). An option that doesn't fit the rule, such as preapprove on a check-out rule, is refused with a 400 that says why.
Scheduled messages. Saving a rule (new, edited, or turned back on) reschedules the messages of the account's existing reservations in the background, the same as saving in Host Tools. A new rule can schedule messages onto bookings that already exist, and some may send right away (for example a check-in rule on a stay that starts today).
Email, SMS and webhooks. sendTo email and sms send the message to the addresses or numbers given instead of the guest. SMS goes to US and Canadian numbers only, and only from accounts with an Airbnb or VRBO account connected. sendTo webhook POSTs the message as JSON ({"data": ...}) to webhookUrl, which must be an https address on the public internet.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
429Too many requests