Skip to main content
POST
/
v22.0
/
106540352242922
/
messages
curl 'https://graph.facebook.com/v22.0
/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "image",
  "image": {
    "id" : "1479537139650973",
    "caption": "The best succulent ever?"
  }
}'

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

Documentation Index

Fetch the complete documentation index at: https://meta-preview.mintlify.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Sending Image Messages

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

​
Request Syntax

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

​
Post Body

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "image",
  "image": {
    "id" : "<MEDIA_ID>", /* Only if using uploaded media */
    "link": "<MEDIA_URL>", /* Only if linking to your media */
    "caption": "<IMAGE_CAPTION_TEXT>"
  }
}

​
Post Body Parameters

​
<IMAGE_CAPTION_TEXT>
string
Image caption text.Maximum 1024 characters.Example: The best succulent ever?
​
<MEDIA_ID>
string
required
Required if using an uploaded media asset (recommended).Uploaded media asset ID.Example: 1479537139650973
​
<MEDIA_URL>
string
required
Required if linking to your media asset (not recommended)URL of image asset on your public server. For better performance, we recommend that you upload your media asset instead.Example: https://www.luckyshrub.com/assets/succulents/aloe.png
​
<WHATSAPP_USER_PHONE_NUMBER>
string
required
Required. WhatsApp user phone number.Example: +16505551234

​
Supported Image Formats

Images must be 8-bit, RGB or RGBA.
Image TypeExtensionMIME TypeMax Size
JPEG.jpegimage/jpeg5 MB
PNG.pngimage/png5 MB

​
Example Request

Example request to send an image message with a caption to a WhatsApp user. 
curl 'https://graph.facebook.com/v22.0
/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "image",
  "image": {
    "id" : "1479537139650973",
    "caption": "The best succulent ever?"
  }
}'

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