SMS Webhook API

A webhook for receiving SMS messages when you need a real, long-term, honest-to-$DEITY cell phone.

Price: $4/month

How to Use:

  1. Subscribe (3 day free trial / terms)
  2. Hit the API like:
    curl \
     -H "Content-Type: application/json" \
     -X POST \
     -d '{"like":"Confirmation code: XXXXXX", "url":"https://yourserver.com/whatever"}' \
     https://littlpig.com/api/smshook/<subscription-id>/listen
    This will return the number you should text:
    {"status":"ok", "number":"555-555-5555", "ttl":300}
  3. When a text comes in your url will receive a POST message like:
    {
      "from": "555-555-1234",
      "date": "12/12/2024",
      "time": "09:10:56",
      "text": "Your confirmation code: 123456",
    }
  4. ... Profit!
  5. [Hopefully much later...] Cancel Subscription

FAQ

How is this so cheap?
I don't pay for web design? 😂
How do I get my subscription id?
It will be emailed to you a few seconds after you subscribe.
Will the number to text ever change?
Checking is advised, but it should stay constant for the life of your subscription.
How long will my listener stay active?
The returned TTL parameter specifies the maximum number of seconds (generally 5 minutes).
How many messages can I receive?
One per API call, and calls are rate limited (per subscription). This service is designed for infrequent texts (like confirmation codes).
Why would I need a "real" cell, not just a virtual / VoIP / Google Voice number?
Some services will only text real numbers.
Why do I have to specify what the message will look like?
To disambiguate who should get what message. You can pass in "*" if you don't know, but expect to miss some.
Disambiguate? This is a shared number?
Numbers are shared, but messages are not public. Only one listener gets any one message. If there are multiple simultaneous listeners the Levenshtein distance (a similarity score) is used to decide which webhook is called. (And you can't register a listener too similar to another active listener.)
Is this a VoIP service?
Nope. Real numbers, real SIMs, real phones.
Do you offer refunds?
For $4, srsly? No. Use the free trial to test, or just cancel.
Why? And why $4?
I needed it for my own project. The cheapest option I found was $8/month. After 30 seconds of intensive market research, I divided by two.