Skip to content

API Documentation

Welcome to the Bot Master Sender API documentation. Our API enables you to send WhatsApp messages programmatically using various methods.

Base URL

https://domain.com/api/v5/

Authentication

All API requests require authentication using your authToken. See the Authentication page for details.

Available Methods

Our API supports multiple methods for sending messages:

  1. GET Request
  2. POST - URL Encoded
  3. POST - JSON Body
  4. POST - Form Data

GET Request

Send a message by passing parameters directly in the URL.

bash
curl --location 'https://domain.com/api/v5/?action=send&senderId=919999999999&authToken=33-z41cepdnttJoLHIZn7zcQitR49dVg2WBMooeAxxxxxxx&messageText=Test+02&receiverId=919425008429&mediaurl=https://domain.com/mms/mms_1727672203.jpg'

POST - URL Encoded

Send a message using URL-encoded form data.

bash
curl --location 'https://domain.com/api/v5/?action=send' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'senderId=919999999999' \
--data-urlencode 'authToken=33-z41cepdnttJoLHIZn7zcQitR49dVg2WBMooeAxxxxxxx' \
--data-urlencode 'messageText=Test 02' \
--data-urlencode 'receiverId=919425008429' \
--data-urlencode 'mediaurl=https://domain.com/mms/mms_1727672203.jpg'

POST - JSON Body

Send a message using JSON data in the request body.

bash
curl --location 'https://domain.com/api/v5/?action=send' \
--header 'Content-Type: application/json' \
--data-raw '{
    "senderId": "919999999999",
    "authToken": "33-z41cepdnttJoLHIZn7zcQitR49dVg2WBMooeAxxxxxxx",
    "messageText": "Test 02",
    "receiverId": "919425008429",
    "mediaurl": "https://domain.com/mms/mms_1727672203.jpg"
}'

POST - Form Data

Send a message with form data, supporting file uploads.

bash
curl --location 'https://domain.com/api/v5/?action=send' \
--form 'senderId="919999999999"' \
--form 'authToken="33-z41cepdnttJoLHIZn7zcQitR49dVg2WBMooeAxxxxxxx"' \
--form 'messageText="Test 02"' \
--form 'receiverId="919425008429"' \
--form 'mediaurl="https://domain.com/mms/mms_1727672203.jpg"' \
--form 'uploadFile=@"/path/to/file.jpg"'

Request Parameters

ParameterTypeRequiredDescription
senderIdstringYesYour WhatsApp sender number
authTokenstringYesYour authentication token
messageTextstringYesThe message to send
receiverIdstringYesRecipient's WhatsApp number
mediaurlstringNoURL of media to send
uploadFilefileNoFile to upload (Form Data only)

Response Format

json
{
    "status": "success",
    "message": "Message sent successfully",
    "messageId": "msg_123456789"
}

Released under the MIT License.