---
title: "Upload media"
method: POST
path: "/whatsapp/media/{phoneNumber}/upload"
tags: ["WhatsApp Media"]
---

# Upload media

`POST /whatsapp/media/{phoneNumber}/upload`

Uploads media that can later be sent in WhatsApp messages. This endpoint interfaces with Meta's WhatsApp Business API media endpoints. All media files sent through this endpoint are encrypted and persist for 30 days.

For supported media types and size limitations, please refer to [Supported Media Types](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types).

For more information, refer to [Meta's WhatsApp Cloud API Media documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media).

Note that all interactive messages cannot send images, documents, videos, or audio using a Media ID in the header section. These elements must be sent using a link.

## Path parameters

- `phoneNumber` string, required

## Response `200`

Successfully uploaded the media.

- object
  - `id` string — The ID of the uploaded media that can be used in subsequent message requests.

## Other responses

- `400` — Bad request. The file may be invalid or exceed size limits.
- `404` — The requested resource does not exist.

---

[API](https://skmtc.dev/ycloud/apis/ycloud-api.md) · [All operations](https://skmtc.dev/ycloud/apis/ycloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ycloud/ycloud-api/revisions/4e13d3ca9df8/schema)