---
title: "Upload file"
method: POST
path: "/streams/forward-upload/{account_phone_number}"
tags: ["Streams Service"]
---

# Upload file

`POST /streams/forward-upload/{account_phone_number}`

Upload a media file to use in WhatsApp sends. The response returns a `media_id` that you then pass to the **Send Media** endpoint. Send the file as `multipart/form-data`.

**Authentication:** stream token in the `Authorization` header (see **Authentication** in the API Overview).

## Path parameters

- `account_phone_number` string, required

## Response `200`

The file was uploaded.

- object
  - `status_code` integer — HTTP status returned by the upstream upload service.
  - `remote_response` object — The upstream upload result.
    - `status` boolean — Whether the upload succeeded.
    - `uploaded_media` object[] — Descriptors for the uploaded file(s).
      - `file_name` string — The original uploaded filename.
      - `media_id` string — The uploaded media ID — pass this to the Send Media endpoint.
      - `download_url` string — URL to retrieve the uploaded media.

---

[API](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1.md) · [All operations](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/commpeak/dialer-api-v2-0-1/revisions/eacecf960bb6/schema)