Simple Messaging

Simple SEND SMS GET

This endpoint allows you to send a simple message using GET method. You’ll need to pass your clientid and clientsecret in the request.

Request Parameters

Parameter	Type	Requirement	Description
clientID	String	Mandatory	ClientId needed to authenticate SMS request.
clientsecret	String	Mandatory	Clientsecret needed to authenticate SMS request.
from	String	Mandatory	SenderId or Name recipients will see.
to	String	Mandatory	Mobile number of recipient.
content	String	Mandatory	Content of the simple message.

Sample HTTP Request

GET
/v1/messages/send?clientsecret=sgrorne&clientid=qoohqvcp&from=Abrantie&to=%2B233546335113&c
ontent="GoTesting" HTTP/1.1
Host: sms.hubtel.com

curl --location 'https://sms.hubtel.com/v1/messages/send?clientsecret=nnhpzrw&clientid=dbetbmg&from=Philip&to=233548359582&content=This%2BIs%2BNot%2Ba%2BDrill' \
--header 'Authorization: Basic bk52RWpPUDpiNDkzZTVhMmRkNTA0cyOTNjNmE5OTc1ZGI3NzM0Ng==' \
--data ''

Response Parameters

Parameter	Type	Description
rate	Number	Cost per sms
messageId	String	Unique identifier of messages
status	Number	Status code of the request
networkId	String	networkId of message
clientReference	String	ClientReference of message. Can be null
statusDescription	String	Brief description of request status.

Sample Response

{
    "rate": 0.0309,
    "messageId": "9c5f3edc-529e-4182-959b-aeb17b9ddad4",
    "status": 0,
    "networkId": "62001",
    "clientReference": null,
    "statusDescription": "request submitted successfully"
}

Simple SEND SMS POST

This endpoint allows you to send a simple message POST method. You’ll also need to authenticate your request with the Basic Auth of your SMS credentials.

Request Parameters

Parameter	Type	Requirement	Description
From	String	Mandatory	SenderId or Name recipients see
To	String	Mandatory	Mobile number of recipient.
Content	String	Mandatory	Content of the simple message

Sample HTTP Request

POST /v1/messages/send HTTP/1.1
Host: sms.hubtel.com
Content-Type: application/json
Authorization: Basic cW9vaHF2Y3A6c2dyb3Juam=
{
    "From": "AbrantieLai",
    "To": "233554123419",
    "Content": " The Job is the JOB"
}

curl --location 'https://sms.hubtel.com/v1/messages/send' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic ZGJyZibWc6bm5oY3B6cnc=' \
--data '{
"From":"AbrantieLai",
"To": "233554123419",
"Content": "The Job is the JOB"
}'

Response Parameters

Parameter	Type	Description
rate	Number	Cost per sms
messageId	String	Unique identifier of messages
status	Number	Status code of the request
networkId	String	networkId of message
clientReference	String	ClientReference of message. Can be null
statusDescription	String	Brief description of request status.

Sample Response

{
    "rate": 0.0309,
    "messageId": "eadbfcd0-94d1-438f-ad32-0013f34042c2",
    "status": 0,
    "networkId": "62001",
    "clientReference": null,
    "statusDescription": "request submitted successfully"
}