API reference · WhatsApp

Upload media

Upload an image or document as multipart/form-data. Use the returned url as media_url.

POST/v1/whatsapp/media

Bearer API key
Rate limit 120 / min
Returns 200 OK
Needs the WhatsApp permission · free

POST /v1/whatsapp/media

curl -X POST https://api.talks.africa/v1/whatsapp/media \
  -H "Authorization: Bearer $TALKS_KEY" \
  -F "[email protected]"

{
  "id": "med_4ka",
  "url": "https://api.talks.africa/v1/whatsapp/media/med_4ka",
  "filename": "catalogue.pdf",
  "content_type": "application/pdf",
  "size_bytes": 1250331
}

Use a tk_test_ key while you build. Nothing is sent and no credits are used.

Body parameters

filebinaryrequired
The file to upload.

Response fieldsResponse

id
File ID
url
Use as media_url
content_type · size_bytes
File details

Errors

Tap one to see its response above.

All errors use the standard error object. Select one to see its response.

Was this page helpful?