Send an image, video, audio, PDF, document or other WhatsApp-supported file using a direct media URL.
https://whatsapp.webloom.co.in/send-media
Request Parameters
Parameter
Type
Required
Description
api_key
string
Yes
Your Webloom API key
sender
string
Yes
Number of your WhatsApp device
number
string
Yes
Recipient WhatsApp number with country code
media_type
string
Yes
image, video, audio or document
url
string
Yes
Direct public URL of the media/file
caption
string
No
Caption / message text
filename
string
No
Filename to display for documents
mimetype
string
No
MIME type of the file (auto-detected if omitted)
Note: the url must be a direct, publicly downloadable link — e.g. https://example.com/image.jpg, https://example.com/file.pdf, https://example.com/document.docx. Cloud-drive share links (Google Drive, Dropbox) are not supported.
Send an interactive WhatsApp message with Reply, URL, Call or Copy buttons.
Heads up: native interactive buttons are sent as WhatsApp interactive messages, and on connections made through WhatsApp Web / QR (which Webloom uses) they may be accepted and delivered but not displayed on the recipient's phone. For a format that always shows, use Send Buttons below.
https://whatsapp.webloom.co.in/send-button
Request Parameters
Parameter
Type
Required
Description
api_key
string
Yes
Your Webloom API key
sender
string
Yes
WhatsApp device name / sender
number
string
Yes
Recipient WhatsApp number with country code
message
string
Yes
Message text
footer
string
No
Optional footer text
button
array
Yes
Interactive button definitions. Maximum 5 buttons.
Important: Reply buttons cannot be mixed with URL, Call or Copy buttons
in the same message. Use Reply buttons by themselves, or use URL/Call/Copy buttons
together without Reply buttons.
Send one message with quick-reply options, a tappable website link and a tappable call number. It is sent as a normal WhatsApp text message, so it displays reliably on every phone. Recipients reply by typing the option number.
https://whatsapp.webloom.co.in/send-buttons
Request Parameters
Parameter
Type
Required
Description
api_key
string
Yes
Your Webloom API key.
sender
string
Yes
Number of your WhatsApp device, with country code.
number
string
Yes
Recipient WhatsApp number, with country code.
message
string
Yes
Main message text.
buttons
string
Optional
Comma-separated quick-reply options, up to 3. Example: Yes,No,Maybe
title
string
Optional
Bold heading shown above the message.
footer
string
Optional
Italic footer text shown under the options.
website_url
string
Optional
Link shown as a tappable line.
website_label
string
Optional
Label for the link. Default: Visit Website
call_number
string
Optional
Phone number shown as a tappable line.
call_label
string
Optional
Label for the number. Default: Call Us
At least one of buttons, website_url or call_number is required.
If your device sent another message a few seconds earlier, the API replies with 202 and queued: true. Messages are paced a few seconds apart to protect your WhatsApp number, and the message is sent automatically after the delay.
Error Responses
Status
Meaning
400
Missing message, or none of buttons / website_url / call_number provided.
401
api_key missing or invalid.
403
Subscription expired.
429
Rate limit exceeded (30 requests per minute) or daily message limit reached.
Flow: call the endpoint once to start pairing, then poll the same endpoint again with the same parameters — the response changes as the connection progresses through the four states below.
If a connected WhatsApp number gets logged out, use the same /generate-qr API to connect it again. No new device or API key is needed. Your device name and API key stay the same.
Steps
Step
What to do
1
POST sender (your WhatsApp number with country code, for example 919876543210) and api_key to https://whatsapp.webloom.co.in/generate-qr. You can send device (your device name) instead of sender.
2
If the reply is processing, wait a few seconds and call again. When it contains qrcode, show the image to the user.
3
The user scans the QR from WhatsApp, under Linked Devices. The QR refreshes about every minute, so keep calling while they scan.
4
Check the User Info API until the status shows Connected. A call to /generate-qr then replies Device already connected!.
Accepted formats. Send the fields as a JSON body, as a form body, or in the URL. A wrong key or a number that does not match returns Invalid API key or sender! and no QR.
Same number only. A device can only be reconnected with the WhatsApp number saved for it. If a different number is scanned, that connection is logged out and the API replies with Wrong number and status 403. Request a new QR and scan it from the correct phone.
Response: wrong number scanned
JSON (403)
{
"status": false,
"msg": "Wrong number. This device can only be connected with the number ending 6760. The scanned number has been disconnected. Request a new QR and scan it from the correct phone."
}
A device with no number saved yet takes the first number that connects. After that it is locked to that number.
GETPOST
User Info
Get WhatsApp device information using your Webloom API key and device number.