Click2Send | SMS API

Our BulkSMS API allows you to connect to our system to send BulkSMS Remotely on your own website or other platforms. You can find your API Key in your client area.

Traditional SMS Request

The only requirement is to POST data to the Click2Send server via JSON. The section below describes how to create this POST with cURL

curl https://click2send.com.ng/bin/api/ \
-H "Auth: Client API_KEY" \
-H "Content-Type: application/json" \
-d '{"cmd":"SMS","SMS":{"Sender":"JohnDoe","Recipient":"23480000000","Message":"Hello world"}}' \
-X POST


SMS With Options (Flash Message)

The network has a provision for options. An example flash message below:

curl https://click2send.com.ng/bin/api/ \
-H "Auth: Client API_KEY" \
-H "Content-Type: application/json" \
-d '{"cmd":"SMS","SMS":{"Sender":"JohnDoe","Recipient":"23480000000","Message":"Hello world","Options":{"flashmessage":"true"}}}' \
-X POST


SMS With Options (MMS)

Sending MMS is in BETA stage. However, you are welcome to get started with MMS anyways.

curl https://click2send.com.ng/bin/api/ \ -H "Auth: Client API_KEY" \ -H "Content-Type: application/json" \ -d '{"cmd":"SMS","SMS":{"Sender":"JohnDoe","Recipient":"23480000000","Message":"Hello world","Options":{"mms":"true","mediaurl":"http://link.pic/picture.png"}}}' \ -X POST
 

The Mediaurl has to be a url or link to an image. PNG or GIF or JPG.

For multiple recipients, please separate entries with comma(,). All recipients should be in international format without (+) sign AND DO NOT urlencode() the message.

Result Format

{
  "code": 1001,
  "response": "SMS Sent Successfuly",
}

Response Codes

1001 - Successfully Sent

8080 - SMS Sending Failure *Undisclosed Reasons*

4081 - Message Rejected (Spam)

4091 - Message Rejected (Flooding)

5025 - Account/Client/User Error (Authorization Error)

6060 - Message Blocked (Blocked)

6061 - Message Declined (Declined)

1010 - Message Pending (Pending)

CTE009 - Routing Error (Failed)

CTE080 - Bounce (Bounce)