DroidSMS makes it really simple and easy for you to turn your Android Phone into a Programmatic SMS Platform to be used by your application. Setting up and getting started is easy. Just follow the following steps:

  1. Install the DroidSMS app on your Android phone
  2. Signin to app using your DroidSMS Credentials
  3. Setup a URL to recieve Incoming SMS Message
  4. Use one of the 3 Outgoing SMS API's to send a message

Select an API below to learn more about it.



Sending a SMS

Make a HTTP POST Request to the following URL with the Content-Type: application/json header set:

http://droidsms.com/api/v1/message

The following parameters are required as part of the Request Body.

{
"apiKey": Your unique API Key (listed in your console),
"to": Destination Number for the SMS Message (eg. 1234567890),
"msg": The text message you want to send (eg. Test message from DroidSMS)
}

API Response will be as follows:

{
"status": Boolean (True/False),
"msg": Text Description of status,
"msgKey": Unique SMS Message confirmation key (only included for a successful message)
}
Sending a SMS to multiple people

Make a HTTP POST Request to the following URL with the Content-Type: application/json header set:

http://droidsms.com/api/v1/samemultimsg

The following parameters are required as part of the Request Body.

{
"apiKey": Your unique API Key (listed in your console),
"to": An array of destination numbers for the SMS Message (eg. [1234567890, 1234567890, 1234567890]),
"msg": The text message you want to send (eg. Test message from DroidSMS)
}

API Response will be as follows:

{
"status": Boolean (True/False),
"msg": Text Description of status,
"msgKey": Unique SMS Message confirmation key (applies to all SMS Messages)
}
Sending multiple SMS message to multiple people

Make a HTTP POST Request to the following URL with the Content-Type: application/json header set:

http://droidsms.com/api/v1/multimsg

The following parameters are required as part of the Request Body.

{
"apiKey": Your unique API Key (listed in your console),
"data": An array of destination number and message objects. Example:
[
{
'to':1234567890,
'msg':'First test message from DroidSMS'
},
{
'to':2223334444,
'msg':'Second test message from DroidSMS'
},
{
'to':5556667788,
'msg':'Final test message from DroidSMS'
}
]

}

API Response will be as follows:

{
"status": Boolean (True/False),
"msg": Text Description of status,
"msgKey": Unique SMS Message confirmation key (applies to all SMS Messages)
}
Recieveing an SMS Message

Your server can recieve the incoming SMS Messages from your phone. All you need to do is enter the URL in the console that should recieve the messages.

DroidSMS will make a HTTP POST request to the specified URL with the Content-Type: application/json header set and the following parameters in the Request Body:

{
"msg": Incoming SMS Text Message,
"to": Phone number of the device recieveing the message,
"from:" Phone number of the device the message originated from,
"id": Unique message key id,
"time": Date / Time Stamp the message was recieved by the device (eg. 2015-05-02 16:50:29.160060)
}