Upload and send a sticker via the API

Paige Finkelstein Updated by Paige Finkelstein

Stickers can be uploaded as media and then sent in WhatsApp messages to users via the API.

Let's look at how you would do this:

  1. Step 1: Upload the media to WhatsApp (as described in the documentation here).
  2. Step 2: The response to the media upload API request will include an id field that can then be used to send the sticker media in messages to users.
Important: Stickers must have a transparent background, be exactly 512 x 512 pixels, and be less than 100 KB in size. Additionally, sticker media must be in webp format. Other file types can be transformed into webp online by using a file conversion site such as cloudconvert.

Example Request:

curl -i -X POST https://whatsapp.turn.io/v1/media -H 'Authorization: Bearer your-token-here' -H 'Content-Type: image/webp'  --data-binary '@/path_to_sticker_file.webp'

If successful, this will generate a response that contains a media id, such as:

{ media":[ {"id":"your-unique-media-id-f6dacb02..."}]…}

Using the id from this response, you can then make a request to send the sticker media to a user’s chat (as described in the documentation here). For example:

curl -X POST https://whatsapp.turn.io/v1/messages  -H 'Authorization: Bearer your-token-here'  -H 'Content-Type: application/json'     -d '
{
"recipient_type": "individual",
"to": "14171234567",
"type": "sticker",
"sticker": {
"id": "your-unique-media-id-f6dacb02..."
}
}
'

Success! Now you can share Chuck Norris with the rest of the world 😉

Was this article helpful?

How do I create message templates via the API?

Replacing the Contact Export API


Contact