Skip to main content

​
WhatsApp Cloud API - Media Upload API

Copy for LLM View as Markdown Version v23.0 Upload media files (images, videos, audio, documents, stickers) to WhatsApp. Returns a media ID that can be used to send media messages. Supports multiple file formats and multipart form-data uploads.

​
Base URL

| https://graph.facebook.com |

​
Endpoints

| POST | ///media |

​
POST ///media

This request uploads an image as .jpeg. The parameters are specified as form-data in the request body.

​
Request Syntax

POST///media Select language cURLJavaScriptPython 
curl --request POST \
  --url 'https://graph.facebook.com/{Version}/{Phone-Number-ID}/media' \
  --header 'Authorization: Bearer <Token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "file": "@/local/path/file.ogg;type=ogg",
  "messaging_product": "whatsapp"
}'
Select status code 200 
\{
  "Upload Audio (form-data)": {
    "value": {
      "id": "&lt;MEDIA_ID&gt;"
    }
  },
  "Upload Audio JSON": {
    "value": {
      "id": "4490709327384033"
    }
  },
  "Upload Image JSON": {
    "value": {
      "id": "4490709327384033"
    }
  },
  "Upload Sticker File (form-data)": {
    "value": {
      "id": "&lt;MEDIA_ID&gt;"
    }
  },
  "Upload Sticker File JSON": {
    "value": {
      "id": "4490709327384033"
    }
  }
}
Header Parameters
User-Agentstring The user agent string identifying the client software making the request. Authorizationstring·required Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token. Path Parameters
Versionstring·required Phone-Number-IDstring·required Request BodyOptional
Content Type: application/json Schema: object Show child attributes
filestring
messaging_productstring Content Type: multipart/form-data Schema: object Show child attributes
filestring (binary)
messaging_productstring Responses
This request uploads an image as .jpeg. The parameters are specified as form-data in the request body. 200 Upload Image JSON / Upload Sticker File (form-data) / Upload Sticker File JSON / Upload Audio (form-data) / Upload Audio JSON Content Type: application/json Schema: object Show child attributes
idstring Select language cURLJavaScriptPython 
curl --request POST \
  --url 'https://graph.facebook.com/{Version}/{Phone-Number-ID}/media' \
  --header 'Authorization: Bearer <Token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "file": "@/local/path/file.ogg;type=ogg",
  "messaging_product": "whatsapp"
}'
Select status code 200 
\{
  "Upload Audio (form-data)": {
    "value": {
      "id": "&lt;MEDIA_ID&gt;"
    }
  },
  "Upload Audio JSON": {
    "value": {
      "id": "4490709327384033"
    }
  },
  "Upload Image JSON": {
    "value": {
      "id": "4490709327384033"
    }
  },
  "Upload Sticker File (form-data)": {
    "value": {
      "id": "&lt;MEDIA_ID&gt;"
    }
  },
  "Upload Sticker File JSON": {
    "value": {
      "id": "4490709327384033"
    }
  }
}

​
Authentication

| Scheme | Type | Location | | bearerAuth | HTTP Bearer | Header: Authorization |

​
Usage Examples

bearerAuth: Include Authorization: Bearer your-token-here in request headers

​
Global Authentication Requirements

All endpoints require: bearerAuth Did you find this page helpful? Thumbs up icon Thumbs down icon