TextBelt

Outgoing SMS API that uses carrier-specific gateways to deliver your text messages for free, and without ads.


TextBelt: The Outgoing SMS API for Free and Without Ads

TextBelt is a self-hosted software project that offers an outgoing SMS API, allowing users to send text messages for free, without ads, and with a high level of reliability. By using carrier-specific gateways, TextBelt provides a mechanism for sending texts that is different from the paid version available at https://textbelt.com.

Main Features

  • Free SMS Sending: Send text messages for free, without ads or any additional costs.
  • Carrier-Specific Gateways: TextBelt uses carrier-specific gateways to deliver your text messages, ensuring reliable and efficient transmission.
  • Simple Integration: Send a text with a simple POST request using tools like curl or integrate with your favorite programming language (Ruby, Go, Python, Node.js, PHP, Bash, HTML/JS/Mobile Webpage, Browser Extension, Windows Phone, SendSMS Mac App, OS X Dashboard Widget, or Windows 7/Vista Gadget).
  • Flexible Configuration: Configure the service on a private server to suit your needs.
  • Robust Performance: TextBelt has sent over 1 million texts and is designed for high-performance SMS sending.

Technical Details

To send a text using the free mechanism, simply make a POST request with the required number and message parameters. For example:

$ curl -X POST http://my_textbelt_server/text \ -d number=5551234567 \ -d "message=I sent this message for free with Textbelt"

If you're using the paid version at https://textbelt.com, you'll need to include your API key in the request:

$ curl -X POST https://textbelt.com/text \ -d number=5551234567 \ -d "message=I sent this message for free with Textbelt" \ -d key=abcdef123456

Success and Failure

When sending a text, you'll receive a response indicating whether the message was successfully delivered to the carrier's list of providers. Sample success and failure responses are shown below:

  • Success: {"success":true}
  • Failure: {"success":false,"message":"Exceeded quota for this phone number."}

Note that while TextBelt can guarantee that your message was sent to its list of providers, it cannot guarantee delivery on your network.

Notes and Limitations

Some carriers may be picky about which messages they deliver. A "success" response from Textbelt means that your message was given to the carrier. Additionally, some carriers may deliver text messages from specific email addresses (e.g., [email protected]) if configured accordingly.

Related

Apprise
MongooseIM
Snikket
Textpattern
Novu
Jami
Tox
FreeSWITCH
Star history

Star history for TextBelt