Developers API Reference
Integrate automated messaging flows directly into your software stack. Our RESTful gateway supports HTTPS payloads and JSON formats.
Authentication
All API requests to SMSBenkad must include your unique API Key in the request header. You can generate API Keys inside your dashboard.
Keep your API keys secure. Never expose keys in client-side applications (like browser JS) or check them into source control directories.
Send SMS Endpoint
Send a standard text message or verification code to a single recipient or list of numbers.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| to | string | Yes | The destination phone number in international E.164 format. |
| sender | string | Yes | Your customized sender name (alphanumeric, max 11 chars). |
| body | string | Yes | The text payload. Unicode/UTF-8 emoji support is built-in. |
Sample PHP Integration Code
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.smsbenkad.com/v1/sms/send",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
"to" => "+15550199",
"sender" => "SMSBenkad",
"body" => "Verification OTP: 482195"
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer sb_live_YOUR_KEY",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Delivery Webhooks
Receive asynchronous delivery reports (DLR) directly to your web server by registering a Webhook URL in your dashboard. Our gateway dispatches POST request notifications the moment carriers update message delivery statuses.
Sample Webhook Payload
{
"event": "message.status_updated",
"data": {
"message_id": "msg_0a8b7c6d5e4f",
"to": "+15550199",
"status": "delivered",
"delivered_at": "2026-07-05T19:30:00Z",
"segments": 1,
"cost": 0.0075
}
}
Check Balance
Verify your account remaining message credits and verify system operational status.