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

 

Required Parameters
KeyValueDescription
Login Credentials (Required)
Authenticate your API request using userid-password or apiKey—choose one method.
useridYour Registered UsernameYour registered username; use if apiKey isn’t provided. Signup for User ID
passwordYour PasswordURL-encoded password (for special characters); use if apiKey isn’t provided. Signup for API Key
Header (optional) Parameters
apiKeyYour unique apiKeyapiKey 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
wabaNumberWABA NumberApproved registered WhatsApp Number
mediaTypeimage|video|documentEnter media type.
identifierimage titleAn identifier to remember about the media.
descriptiondescriptionThis is test image.
outputplain|json|plainValue 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.

 

Sample Request Code
<?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;

 

Sample Response Code
{
    "status": "success",
    "mediaId": "7074855483357676350",
    "statusCode": "200",
    "reason": "success"
}

 

Error Code Explanation
{
    "status": "success",
    "mediaId": "7074855483357676350",
    "statusCode": "200",
    "reason": "success"
}
CTA for Unlock Real-Time Messaging – Integrate Today!

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 up

Testimonials

Why do Great Businesses Trust SMS Gateway Center?

K

Kurlon IT

2022-08-04

We have tied up with other SMS providers also, but SMS GatewayCenter is quite good. Good Service from the team. We are very happy with the service be it accounts related or technical issue. We always get good response.

I

INOX Air Products

2018-02-09

We have an excellent experience with SMS Gateway Center. The services and support has been of very high standard.

S

Shalabh Arora

2025-04-11

I’ve been using SMSGatewayCenter’s bulk SMS and WhatsApp services since early 2022 for my small business, and the experience has been fantastic. The platform is intuitive, and the message delivery is incredibly reliable, reaching my customers without fail. The 24/7 support team is quick to assist, and the cost-effectiveness is a big plus. It’s transformed how I connect with my audience, and I highly recommend it to other entrepreneurs! (Google Revirews)

R

Reflex

2025-04-11

We’ve been using your bulk SMS services for a few months, and the results have been phenomenal. The open rates and customer engagement have gone through the roof. Highly recommend for any business looking to scale fast! (Google Revirews)

V

Vedanth Gowda

2025-04-18

I’m Vedanth Gowda, leading a finance business, and I’ve been leveraging SMSGatewayCenter’s bulk SMS and WhatsApp tools —absolutely transformative! The platform’s speed and precision in delivering financial alerts to my clients are unmatched, giving me a competitive edge. Samrat’s expertise in tailoring notification workflows for market updates was a standout, and the robust security features instilled trust. The affordable pricing and proactive support team make it a no-brainer. Perfect for finance pros aiming to elevate client trust and efficiency! (Google Revirews)

N

Naval Bhatnagar

2025-04-12

From day one, the team at SMS GATEWAY CENTER guided us through setup, testing, and launching campaigns. Their support is A+. Whether you’re new to SMS marketing or experienced, they make it smooth. Thank you Aakash. (Google Revirews)