GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing docs.httpsms.com — Getting Started | httpSMS

For the complete documentation index, see llms.txt. This page is also available as Markdown.

Authentication

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 https://httpsms.com/settings

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 👉 https://github.com/NdoleStudio/httpsms/releases/latest/download/HttpSms.apk

Send an SMS

To send an SMS message using an android phone, send an authenticated POST request to the https://api.httpsms.com/v1/messages/send endpoint.

Send an SMS message

post

Add a new SMS message to be sent by your Android phone

Authorizations

x-api-KeystringRequired

Body

attachmentsstring[]Optional

Attachments are optional. When you provide a list of attachments, the message will be sent out as an MMS

Example: ["https://example.com/image.jpg","https://example.com/video.mp4"]

contentstringRequiredExample: This is a sample text message

encryptedbooleanOptional

Encrypted is an optional parameter used to determine if the content is end-to-end encrypted. Make sure to set the encryption key on the httpSMS mobile app

fromstringRequiredExample: +18005550199

request_idstringOptional

RequestID is an optional parameter used to track a request from the client's perspective

Example: 153554b5-ae44-44a0-8f4f-7bbac5657ad4

send_atstringOptional

SendAt is an optional parameter used to schedule a message to be sent in the future. The time is considered to be in your profile's local timezone and you can queue messages for up to 20 days (480 hours) in the future.

Example: 2025-12-19T16:39:57-08:00

tostringRequiredExample: +18005550100

Responses

200

application/json

messagestringRequiredExample: Request handled successfully

statusstringRequiredExample: success

400

Bad Request

application/json

401

Unauthorized

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/messages/send

POST /v1/messages/send HTTP/1.1
Host: api.httpsms.com
x-api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 273

{
  "attachments": [
    "https://example.com/image.jpg",
    "https://example.com/video.mp4"
  ],
  "content": "This is a sample text message",
  "encrypted": false,
  "from": "+18005550199",
  "request_id": "153554b5-ae44-44a0-8f4f-7bbac5657ad4",
  "send_at": "2025-12-19T16:39:57-08:00",
  "to": "+18005550100"
}

{
  "data": {
    "attachments": [
      "https://example.com/image.jpg",
      "https://example.com/video.mp4"
    ],
    "contact": "+18005550100",
    "content": "This is a sample text message",
    "created_at": "2022-06-05T14:26:02.302718+03:00",
    "delivered_at": "2022-06-05T14:26:09.527976+03:00",
    "encrypted": false,
    "expired_at": "2022-06-05T14:26:09.527976+03:00",
    "failed_at": "2022-06-05T14:26:09.527976+03:00",
    "failure_reason": "UNKNOWN",
    "id": "32343a19-da5e-4b1b-a767-3298a73703cb",
    "last_attempted_at": "2022-06-05T14:26:09.527976+03:00",
    "max_send_attempts": 1,
    "order_timestamp": "2022-06-05T14:26:09.527976+03:00",
    "owner": "+18005550199",
    "received_at": "2022-06-05T14:26:09.527976+03:00",
    "request_id": "153554b5-ae44-44a0-8f4f-7bbac5657ad4",
    "request_received_at": "2022-06-05T14:26:01.520828+03:00",
    "scheduled_at": "2022-06-05T14:26:09.527976+03:00",
    "scheduled_send_time": "2022-06-05T14:26:09.527976+03:00",
    "send_attempt_count": 0,
    "send_time": 133414,
    "sent_at": "2022-06-05T14:26:09.527976+03:00",
    "sim": "DEFAULT",
    "status": "pending",
    "type": "mobile-terminated",
    "updated_at": "2022-06-05T14:26:10.303278+03:00",
    "user_id": "WB7DRDWrJZRGbYrv2CKGkqbzvqdC"
  },
  "message": "Request handled successfully",
  "status": "success"
}

You can also use the code samples below to send an SMS message using our API on your favorite programing language.

Install

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

NextIntroduction

Last updated 6 months ago

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.