---
title: "Uploading Media Assets to WhatsApp Business API (Step-by-Step)"
description: "1. Prepare the file: confirm format/size, plan a descriptive identifier, and ensure you have an active WABA connection. 2. Open WhatsApp → Media Library → Add. 3. Select the correct WABA number (if more than one). 4. Fill in Identifier…"
url: "https://www.smsgatewaycenter.com/blog/kb/uploading-media-assets-to-whatsapp-business-api-step-by-step/"
updated: "2025-11-13"
category: WhatsApp Business API / Media Library
---

# Uploading Media Assets to WhatsApp Business API (Step-by-Step)

1. Prepare the file: confirm format/size, plan a descriptive identifier, and ensure you have an active WABA connection.
2. Open WhatsApp → Media Library → Add.
3. Select the correct WABA number (if more than one).
4. Fill in Identifier and Description with meaningful content.
5. Choose the Media Type (image, document, audio, video, etc.).
6. Upload the file. The system validates size/type before calling the WhatsApp media endpoint.
7. Click Save Changes; wait for the progress indicator. On success you’re redirected to Manage with a confirmation.
8. If an error appears (“Select media type”, “Description cannot be blank”, mismatched WABA, API failure), correct the issue and try again.
9. After upload, the asset is searchable in the Manage table. Always double-check the entry before referencing the media ID in templates or automations.

### More Related Articles

- [WhatsApp Media Library Overview: Structure, Permissions & Daily Use](https://www.smsgatewaycenter.com/blog/kb/whatsapp-media-library-overview-structure-permissions-daily-use/)
- [Managing & Deleting Media: Searches, Filters, and Clean-Up Workflow](https://www.smsgatewaycenter.com/blog/kb/managing-deleting-media-searches-filters-and-clean-up-workflow/)
- [Best Practices for WhatsApp Media Identifiers, Descriptions & Multi-Account Setups](https://www.smsgatewaycenter.com/blog/kb/best-practices-for-whatsapp-media-identifiers-descriptions-multi-account-setups/)

Found this useful?[Add as Preferred Source on Google](https://www.google.com/preferences/source?q=smsgatewaycenter.com)