Getting Started

httpSMS is an open-source service that converts your Android phone into an SMS Gateway so you can send and receive SMS messages using an intuitive HTTP API with support for end-to-end encryption.


API requests to httpSMS are authenticated using API keys in the x-api-key header. Any request that doesn't include an API key will return a 401 (Unauthorized) response.

You can get your API key from the dashboard at

Install the Android App

To send and receive SMS messages using your android phone, you will need to download and install our android app on your phone so it can be triggered to send an SMS message when you make a request to the HTTP SMS API.

Android App 👉

Send an SMS

To send an SMS message using an android phone, send an authenticated POST request to the endpoint.

// initialize guzzle client
$client = new GuzzleHttp\Client();

$apiKey = "Get API Key from";

$res = $client->request('POST', '', [
  'headers' => [
    'x-api-key' => $apiKey,
  'json'    => [
    'content' => 'This is a sample text message',
    'from'    => "+18005550199",
    'to'      => '+18005550100'

echo $res->getBody(); 


The best way to interact with the httpSMS API is by using one of our official SDK client libraries:

npm install httpsms
# or
yarn install httpsms

Last updated