> For the complete documentation index, see [llms.txt](https://wadocs.pepipost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wadocs.pepipost.com/sending-message/media-api/upload-media.md).

# Upload Media

This endpoint uploads a media . 

**URL:**&#x200B; ​<https://waapi.pepipost.com/api/v2/media/upload​/>&#x20;

**Method:** POST

#### Parameters

| Parameter | Description | Parameter Type | Data Type     | Sample Value | Required |
| --------- | ----------- | -------------- | ------------- | ------------ | -------- |
| file      | Media file  | Body parameter | MultipartFile |              | Yes      |

#### Request Body

Type: form-data&#x20;

Key : file

&#x20;Value : file you want to upload

### Responses

#### In case of success

```
{ 
   "status": "success", 
   "message": "Media uploaded successfully.", 
   "data": { 
       "mediaId": "e8500978-08e9-45b4-b756-d7f6c92f1d34" 
   } 
} 
```

#### In case of failure

```
{ 
   "status": "failure", 
   "error": { 
       "code": "8006", 
       "message": " Parameter file is required. Please upload a valid file." 
   } 
} 
```

According to error, code and message will change.