TextBee API
TextBee is a self-hosted, open-source SMS gateway for developers and homelab users that uses Android phones to send and receive text messages via a web…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
76/100 Good
- Maintained
- 100last commit 17 days ago
- Popular
- 703,274 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 17 days ago
- GitHub stars
- 3,274
- Open issues
- 57
- Last commit
- 2026-11-04
- Latest release
- v2.9.0
- License
- AGPL-3.0
- Activity
- steady
Checked 17 days ago - source: GitHub (textbee/textbee)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Add your API key and device ID When pulling message history, include your API key in the x-api-key header and use the device ID (the unique code for your Android device). If either is missing or wrong, the API won’t return the messages for that device. source
- Give the service a public webhook URL Before starting, provide a public web address that can receive POST requests (incoming web requests) and choose the SMS events you want. If TextBee can’t reach that URL, it can’t send you real-time message or delivery updates. source
- Confirm webhook deliveries work In your webhook handler, reply with 200 OK (a success code) so TextBee knows the event arrived, and use your secret to verify the request came from TextBee. Without this, you may miss events or process fake requests. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives (1)
- Twilio - Twilio is a web-service API that lets you use your existing web languages and skills to build voice and SMS applications.
Checked 40 days ago - source: AlternativeTo
Common questions
How do I pair an Android phone with TextBee?
Install the TextBee app, grant it SMS permissions, and open the dashboard to register the device or generate an API key. Then scan the QR code with the app or enter the API key manually.
What header details are required to pull message history from the TextBee API?
Include your API key in the x-api-key header and use the device ID for the Android device. If either value is missing or wrong, the API will not return messages for that device.
What must a webhook endpoint do for TextBee webhook delivery to work?
Provide a public URL that can receive POST requests and select the SMS events you want. The handler should reply with 200 OK and use the webhook secret to verify that the request came from TextBee.
Can TextBee send to multiple recipients in one API request?
Yes, its bulk messaging supports sending to many recipients in a single API call. This is intended for campaigns, alerts, and broadcasts.
Answers sourced from github.com, textbee.dev, textbee.dev, textbee.dev
Community
- textbee.dev - Open-source SMS Gateway : r/foss - Reddit (reddit)
- textbee.dev - Open-source Android SMS Gateway : r/fossdroid - Reddit (reddit)
- I developed an opensource sms gateway - TextBee : r/fossdroid (reddit)
Collected 49 days ago - public community threads