Send Generalized Messages

Send Generalized Messages.

https://frogapi.wigal.com.gh/api/v3/sms/send

Request Object

Field	Type	Description
senderid	string	The senderID used for sending message. Approved SenderIDs only
destination	string	Recipient Phone Number.
msgid	string	Your message ID.
message	string	The message to be sent.
smstype	string	The type of message to be sent. Default is text.

Response Object

Field	Type	Description
status	string	The status of the request.
message	string	The message response.

Responses

Field	Type	Description
status	string	Returns "ACCEPTD" when message is successfully queued
message	string	Returns "Message Accepted For Processing" on success

Field	Type	Description
status	string	Error status code ("INVALID_REQUEST")
message	string	Detailed error message explaining the issue

Field	Type	Description
status	string	Error status code ("UNAUTHORIZED")
message	string	Message Response

Field	Type	Description
status	string	Error status code ("FORBIDDEN")
message	string	Message Response

Field	Type	Description
status	string	Error status code (e.g., "SENDER_ID_NOT_FOUND")
message	string	Detailed error message explaining the issue
data	null	No data returned for error responses

Field	Type	Description
status	string	Returns "ERROR" for server errors
message	string	Generic error message "Internal server error"

Endpoint

Content type

application/json

Example

Send General Message

curl -X POST 'https://frogapi.wigal.com.gh/api/v3/sms/send'
-H "API-KEY: your_api_key_here"
-H "USERNAME: your_username_here"
-d '{request_body_here}'

const apiKey = 'your_api_key_here'; // Replace with your API Key
const username = 'your_username_here'; // Replace with your Username
const postData = {
    "senderid": "Lomo Inc",
    "destinations": [{
        "destination": "0222222222",
        "msgid": "MGS1010101"
    }],
    "message": "This is a sample message for SMS sending via FrogAPI.",
    "smstype": "text"
};

fetch('https://frogapi.wigal.com.gh/api/v3/sms/send', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'API-KEY': apiKey,
        'USERNAME': username
    },
    body: JSON.stringify(postData)
})
.then(response => response.json())
.then(data => {
    console.log(data);
})
.catch(error => {
    console.error('Error:', error);
});

import requests
import json

api_key = 'your_api_key_here' # Replace with your API Key
username = 'your_username_here' # Replace with your Username
post_data = {
    'senderid': 'Lomo Inc',
    'destinations': [{
        'destination': '0222222222',
        'msgid': 'MGS1010101'
    }],
    'message': 'This is a sample message for SMS sending via FrogAPI.',
    'smstype': 'text'
}

headers = {
    'Content-Type': 'application/json',
    'API-KEY': api_key,
    'USERNAME': username
}

response = requests.post('https://frogapi.wigal.com.gh/api/v3/sms/send', headers=headers, data=json.dumps(post_data))

print(response.json())

<?php
$apiKey = 'your_api_key_here'; // Replace with your API Key
$username = 'your_username_here'; // Replace with your Username
$postData = [
    'senderid' => 'Lomo Inc',
    'destinations' => [[
        'destination' => '0222222222',
        'msgid' => 'MGS1010101'
    ]],
    'message' => 'This is a sample message for SMS sending via FrogAPI.',
    'smstype' => 'text'
];

$ch = curl_init('https://frogapi.wigal.com.gh/api/v3/sms/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'API-KEY: ' . $apiKey,
    'USERNAME: ' . $username
));
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData));

$response = curl_exec($ch);
if(curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
} else {
    echo $response;
}
curl_close($ch);
?>

Request Object

200

Content type

application/json

{
              "senderid": "Lomo Inc",
              "destinations": [
                {
                  "destination": "0222222222",
                  "msgid": "MGS1010101"
                }
              ],
              "message": "This is a sample message for SMS sending via FrogAPI.",
              "smstype": "text"
            }

Response Object

Content type

application/json

{
                "status": "ACCEPTD",
                "message": "Message Accepted For Processing"
            }