Upload Media to WhatsApp Business API
Upload Media for SMSGatewayCenter APIs
Introduction to SMSGatewayCenter APIs
Welcome to SMSGatewayCenter’s API documentation hub! This guide introduces the Upload Media to WhatsApp Business API, a vital feature in our messaging suite, including SMS API for bulk messaging, WhatsApp Business API for customer engagement, Voice Call API for automated alerts, and Two-Way SMS API for interactive communication. This API supports only POST methods over HTTP, enabling you to upload media (e.g., images, documents, videos) to WhatsApp’s cloud servers for use in WhatsApp messages. Perfect for developers in India, enhance your campaigns with our SMS gateway at unify.smsgateway.center/signup/!
Use the Upload Media API to upload files like images, PDFs, or videos to WhatsApp’s cloud, receiving a media object ID for sending rich media messages. This endpoint boosts your WhatsApp Business strategy by enabling personalized, engaging communication with customers.
API Endpoint
https://unify.smsgateway.center/WAApi/media
Key | Value | Description |
---|---|---|
Login Credentials (Required) | ||
Authenticate your API request using userid-password or apiKey—choose one method. | ||
userid | Your Registered Username | Your registered username; use if apiKey isn’t provided. Signup for User ID |
password | Your Password | URL-encoded password (for special characters); use if apiKey isn’t provided. Signup for API Key |
Header (optional) Parameters | ||
apiKey | Your unique apiKey | apiKey needs to be sent as HTTP header when you are not using userid-password method. You can avail this from your user control panel and use instead of userid-password HTTP Request parameter. Please do not disclose this to anyone. |
Required Parameters | ||
wabaNumber | WABA Number | Approved registered WhatsApp Number |
mediaType | image|video|document | Enter media type. |
identifier | image title | An identifier to remember about the media. |
description | description | This is test image. |
output | plain|json|plain | Value for response format.System default is plain. If you need responses in json or plain then you have to give value as json or plain. |
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://unify.smsgateway.center/WAApi/media',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => array('userid' => 'YourUsername','password' => '••••••','wabaNumber' => '9170396xxxxx','output' => 'json','mediaType' => 'image','identifier' => 'ImageTesting','description' => 'This is test image','mediaFile'=> new CURLFILE('/Users/smsgatewaycenter/Downloads/unnamed.jpg')),
CURLOPT_HTTPHEADER => array(
'Cookie: SERVERID=webC1'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
{
"status": "success",
"mediaId": "7074855483357676350",
"statusCode": "200",
"reason": "success"
}
{
"status": "success",
"mediaId": "7074855483357676350",
"statusCode": "200",
"reason": "success"
}

Unlock Real-Time Messaging – Integrate Today!
Try Our API in a Sandbox Environment Before Going Live!
Join Thousands of Developers – Try Our API Now!
Get in touchSign upTestimonials
Why do Great Businesses Trust SMS Gateway Center?