> For the complete documentation index, see [llms.txt](https://support.whapi.cloud/help-desk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.whapi.cloud/help-desk/sending/overview-of-other-methods-for-sending/send-stories.md).

# Send  Stories

### How to publish a Story

Use the [Create & publish story](https://whapi.readme.io/reference/createstory) method.

You must choose **one of two mutually exclusive types**:

* **Media story** — provide a `media` field (URL, base64, or file ID) with an optional `caption`.
* **Text story** — provide `caption` (the text), `background_color`, `caption_color`, and optionally `font_type`. No `media` field.

There are also type-specific methods:

* [Post text story](https://whapi.readme.io/reference/createstorytext) method
* [Post media story](https://whapi.readme.io/reference/createstorymedia) method
* [Post audio story](https://whapi.readme.io/reference/createstoryaudio) method

> **Note:** Your story will only be visible to contacts who have your number saved in their address book.

***

### How to send a Story to all contacts at once

Use the [Create & publish story](https://whapi.readme.io/reference/createstory) method and **omit the `contacts` parameter**. When `contacts` is not specified, Whapi automatically fetches your full contact list and sends the story to all of them.

If you have **more than 10 000 contacts**, send stories in batches by splitting the list and passing groups via the `contacts` parameter. This avoids timeouts and ensures reliable delivery.

***

### How to check Story views

To see who viewed your story, use the [Get group message or story view statuses](https://whapi.readme.io/reference/getmessageviewstatuses) method with the `MessageID` of the story.

You can also track views in real time via webhooks — subscribe to the `statuses.post` and `statuses.put` events. Note that webhook-based view tracking for stories may not be fully reliable in all cases.

***

### How to delete a Story

Deleting stories via the API is **not currently supported** due to technical limitations in how WhatsApp handles status deletion internally.

Stories expire automatically after 24 hours per WhatsApp's standard behavior.