> ## Documentation Index
> Fetch the complete documentation index at: https://docs.way.co/llms.txt
> Use this file to discover all available pages before exploring further.

# listing.unpublished

> Fires when a listing - an experience or a collection - is unpublished.

## When it fires

Way sends `listing.unpublished` when a listing is unpublished - when an experience is unpublished or when a collection is unpublished.

Events arrive at your endpoint as a `POST` request with the body `{ "event": "listing.unpublished", "payload": { ... } }`. When a webhook secret is set, the `X-Way-Signature` header carries an HMAC of the request body - see [Verify signatures](/webhooks/verify-signatures).

## Payload

| Field                       | Type           | Description                                                                      |
| --------------------------- | -------------- | -------------------------------------------------------------------------------- |
| `listingId`                 | string (UUID)  | Unique identifier of the listing.                                                |
| `name`                      | string         | Title of the listing.                                                            |
| `description`               | string         | Description of the listing, as HTML.                                             |
| `productLine`               | string         | Product line of the listing: `activate`, `host`, or `reserve`.                   |
| `kind`                      | string         | Kind of listing: `experience`, `resource` (a collection), `event`, or `auction`. |
| `brand.id`                  | string (UUID)  | Unique identifier of the brand.                                                  |
| `brand.name`                | string         | Display name of the brand.                                                       |
| `brand.tier`                | string         | Subscription tier of the brand.                                                  |
| `brand.countryCode`         | string         | Country code of the brand.                                                       |
| `brand.currency`            | string         | Currency code used by the brand.                                                 |
| `brand.externalReferenceId` | string \| null | External reference identifier configured for the brand.                          |

## Sample

<Note>Illustrative payload derived from the event schema.</Note>

```json theme={null}
{
  "event": "listing.unpublished",
  "payload": {
    "listingId": "b8459588-c7f3-42ed-a010-d455917b676e",
    "name": "Cabana Rental",
    "description": "<p>Indulge in the epitome of poolside luxury with our combined offering of an adult cabana and daybed rental, designed for discerning guests seeking an unparalleled relaxation experience.</p>",
    "productLine": "reserve",
    "kind": "resource",
    "brand": {
      "id": "8e12bfdc-a74c-48e2-8a76-2996a359c10c",
      "name": "The Seaside Hotel",
      "tier": "growth",
      "currency": "USD",
      "countryCode": "US",
      "externalReferenceId": "ABC"
    }
  }
}
```

## Related endpoints

Retrieve the full listing with [Get Listing](/api-reference/listings/get-listing).