Send Stories

WhatsApp Stories (statuses) are available through the Whapi API. This article covers how to publish, view, and manage them.

How to publish a Story

Use the Create & publish story 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:

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 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 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.

Last updated