Sticker Messages

Sticker messages display animated or static sticker images in a WhatsApp message.

Sending Video Messages

Use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send a sticker message to a WhatsApp user.

Request Syntax

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

Post Body

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "{{wa-user-phone-number}}",
  "type": "sticker",
  "sticker": {
    "id" : "<MEDIA_ID>"
  }
}

Post Body Parameters

PlaceholderDescriptionExample Value

<MEDIA_ID>

String

Required if using an uploaded media asset (recommended).

Uploaded media asset ID.

798882015472548

<MEDIA_URL>

String

Required if linking to your media asset (not recommended)

URL of sticker asset on your public server. For better performance, we recommend that you upload your media asset instead.

https://www.luckyshrub.com/assets/animated-smiling-plant.webp

<WHATSAPP_USER_PHONE_NUMBER>

String

Required.

WhatsApp user phone number.

+16505551234

Supported Sticker Formats

Sticker TypeExtensionMIME TypeMax Size

Animated sticker

.webp

image/webp

500 KB

Static sticker

.webp

image/webp

100 KB

Example Request

Example request to send an animated sticker image to a WhatsApp user.

curl 'https://graph.facebook.com/v21.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "sticker",
  "sticker": {
    "id" : "798882015472548"
  }
}'

Example Response

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}