---
title: "Send Special Offer"
method: POST
path: "/conversations/{conversation_id}/special_offers"
tags: ["Messages"]
---

# Send Special Offer

`POST /conversations/{conversation_id}/special_offers`

Send a special offer to the guest in a conversation. A special offer invites the guest to book the given listing for the given dates at a custom total price, and typically expires 24 hours after being sent. Supported on Airbnb and booking-site (direct booking) conversations only; requests on other channels return an error. For booking-site conversations, `rate_plan_id` and `currency` are also required.

## Path parameters

- `conversation_id` string, required

## Request body

- object
  - `listing_id` string, required — The channel listing id to offer, as returned by `GET /listings`.
  - `check_in_date` string, date, required — Check-in date of the offered stay, `YYYY-MM-DD`.
  - `check_out_date` string, date, required — Check-out date of the offered stay, `YYYY-MM-DD`. Must be after `check_in_date`.
  - `price` number, required — Total price for the whole stay, in major currency units (not per night).
  - `number_of_adults` integer, required — Number of adults.
  - `number_of_children` integer — Number of children. Defaults to 0.
  - `number_of_infants` integer — Number of infants. Defaults to 0.
  - `number_of_pets` integer — Number of pets. Defaults to 0.
  - `rate_plan_id` string — The rate plan to offer. Required for booking-site (direct booking) conversations; ignored on Airbnb.
  - `currency` string — Currency code of `price`, e.g. `USD`. Required for booking-site (direct booking) conversations; ignored on Airbnb.

## Response `200`

The request has been successfully submitted.

- CommonResponse
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.

---

[API](https://skmtc.net/hostex/apis/hostex-api.md) · [All operations](https://skmtc.net/hostex/apis/hostex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostex/hostex-api/versions/a3fa555dee66/schema)