Skip to main content

WhatsApp Cloud API - Media Upload API | Developer Documentation

WhatsApp Cloud API - Media Upload API

Copy for LLM
Version
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 URLAuthentication

https://graph.facebook.comScheme
Type
Location

Endpoints

POST /{Version}/{Phone-Number-ID}/media

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

Request Syntax

POST /{Version}/{Phone-Number-ID}/media
Try it
Select language
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
{
  "Upload Audio (form-data)": {
    "value": {
      "id": "<MEDIA_ID>"
    }
  },
  "Upload Audio JSON": {
    "value": {
      "id": "4490709327384033"
    }
  },
  "Upload Image JSON": {
    "value": {
      "id": "4490709327384033"
    }
  },
  "Upload Sticker File (form-data)": {
    "value": {
      "id": "<MEDIA_ID>"
    }
  },
  "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
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
{
  "Upload Audio (form-data)": {
    "value": {
      "id": "<MEDIA_ID>"
    }
  },
  "Upload Audio JSON": {
    "value": {
      "id": "4490709327384033"
    }
  },
  "Upload Image JSON": {
    "value": {
      "id": "4490709327384033"
    }
  },
  "Upload Sticker File (form-data)": {
    "value": {
      "id": "<MEDIA_ID>"
    }
  },
  "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
Back to top