Browse guides

Sticker Messages

How to send a sticker message on the WhatsApp Cloud API, including the WebP format requirement and size limits for static and animated stickers.

On this page

A sticker message sends a WhatsApp sticker to a recipient. Stickers must be WebP format. No caption is supported. Provide the file via URL or media ID. See Media by URL vs Media ID.

Send by URL#

json
{
  "messaging_product": "whatsapp",
  "to": "919959623255",
  "type": "sticker",
  "sticker": {
    "link": "https://example.com/sticker.webp"
  }
}

Send by Media ID#

json
{
  "messaging_product": "whatsapp",
  "to": "919959623255",
  "type": "sticker",
  "sticker": {
    "id": "1234567890"
  }
}

Format requirements#

TypeFormatMax sizeDimensions
Static stickerWebP100 KB512 × 512 px
Animated stickerWebP500 KB512 × 512 px
  • Only WebP is accepted. PNG, GIF, and other formats will fail.
  • Stickers do not support a caption field.

Reference image#

Sticker example
A sticker message in WhatsApp — a static or animated WebP sticker in the chat.

Frequently asked#

How do I send a sticker on WhatsApp API?

Set type to "sticker" and provide the WebP file in sticker.link or sticker.id. The file must be WebP format, 512×512 px, and under 100 KB (static) or 500 KB (animated).

What format does a WhatsApp sticker need to be?

WebP only. Convert your image or GIF to WebP before sending. Static stickers must be under 100 KB, animated under 500 KB.

Can I add a caption to a sticker?

No. Stickers do not support captions.

Gotchas & common mistakes#

Still stuck? Open a support ticket and our team will help.