Send a sticker message

Sends a sticker. Needs an open 24-hour window. Stickers must be uploaded first with POST /v1/media/upload — there’s no link option, unlike other media types.

Example

curl -X POST "$HELLO_API_URL/v1/<your-phone-number-id>/messages" \
  -H "Authorization: Bearer $HELLO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919999999999",
    "type": "sticker",
    "sticker": { "id": "1099999999997890" }
  }'

Response

202 Accepted (queued), or 200 with ?sync=true once WhatsApp accepts it. See Send a message.

Fields

Field	Type	Required	Description
`sticker.id`	string	Yes	`media_id` from `/v1/media/upload`

Supported format: static image/webp, up to 100 KB. Animated stickers aren’t supported.

Common errors

Status	`code`	Cause
`403`	`OUTSIDE_24H_WINDOW`	The recipient’s 24-hour window is closed
`400`	`VALIDATION_ERROR`	`sticker` is missing or the wrong shape
`422`	`SEND_FAILED`	(`?sync=true` only) `sticker.id` isn’t a valid, unexpired media ID, or WhatsApp rejected the file