textbee.dev SMS Gateway Quickstart

Transform your Android phone into a powerful SMS gateway in just 5 minutes. Send and receive text messages programmatically through your applications with textbee.dev.

The Simplest Way to Add SMS Integration to Your Applications

textbee.dev turns any Android phone into a reliable SMS gateway, allowing you to send and receive text messages programmatically. Whether you're building a notification system, implementing two-factor authentication, or creating marketing campaigns, textbee.dev provides a cost-effective solution without the need for complexity.

Follow this step-by-step guide to set up textbee.dev and start sending your first SMS messages in minutes. Our straightforward process requires minimal technical knowledge and works with any application or service that can make HTTP requests.

Step 1: Account Setup

Begin by creating your textbee.dev account and installing the Android app. This setup process takes less than 2 minutes and only requires basic permissions to send and receive SMS messages.

1. Create account

2. Install app

Download the app from textbee.dev/download

3. Grant permissions

Allow SMS access in the app to enable message sending and receiving

Step 2: Connect Your Device

Link your Android phone to your textbee.dev account to establish the SMS gateway connection. This secure connection allows your applications to send messages through your phone.

QR Code Method (Recommended)

Go to textbee.dev Dashboard
Click "Register Device"
Scan QR with app

Manual Method

Generate API key from dashboard
Open textbee.dev app
Enter the API key

Step 3: Send Your First SMS

Start sending SMS messages through textbee.dev using either our intuitive dashboard or direct API integration. Both methods provide reliable message delivery with delivery status tracking.

Dashboard Method

Go to "Send SMS" section
Enter recipient(s)
Type your message
Click "Send"

API Method

fetch("https://api.textbee.dev/api/v1/gateway/devices/{ID}/send-sms", {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': API_KEY,
  },
  body: JSON.stringify({
    recipients: ['+1234567890'],
    message: 'Hello!'
  })
})

With textbee.dev, your messages are sent directly through your Android device, using your existing mobile plan. This keeps costs low while maintaining high deliverability rates across all carriers.

Step 4: Receive SMS Messages

Enable two-way communication by configuring textbee.dev to forward incoming SMS messages to your application. This is essential for interactive workflows, verification codes, and customer engagement.

Enable in App

Open the textbee.dev App
Go to Settings
Toggle "Receive SMS" on

Recommended: Webhooks (Real-time)

For real-time SMS receiving, we recommend using webhooks. This approach delivers incoming messages immediately to your application without the need to poll the API.

Setup Webhook

Go to textbee.dev/dashboard and click "Create Webhook"
Enter your delivery URL (e.g., https://your-server.com/webhook)
Select events you want to receive (e.g., "Message Received")
Save your webhook secret for signature verification

When an SMS is received, textbee.dev will send a POST request to your webhook URL with the message data. Your endpoint should return a 2XX status code within 10 seconds.

Webhook Example

// Express.js webhook endpoint
app.post('/webhook', express.json(), async (req, res) => {
  const payload = req.body;
  
  // Verify signature (recommended for production)
  // const signature = req.headers['x-signature'];
  // verifyWebhookSignature(payload, signature, WEBHOOK_SECRET);
  
  // Process incoming SMS
  if (payload.webhookEvent === 'MESSAGE_RECEIVED') {
    console.log('Received SMS:', payload.message, 'from', payload.sender);
    // Handle the message (save to database, respond, etc.)
  }
  
  res.status(200).send('OK');
});

Webhook Payload:

{
  "smsId": "smsId",
  "sender": "+123456789",
  "message": "Hello!",
  "receivedAt": "2025-10-05T13:00:35.208Z",
  "deviceId": "deviceId",
  "webhookEvent": "MESSAGE_RECEIVED"
}

Note: Always verify the X-Signature header in production using HMAC_SHA256 for security. See our use cases guide for complete signature verification examples.

Alternative: Fetching via API (Polling)

If webhooks aren't suitable for your setup, you can periodically fetch received messages:

const response = await fetch(
  "https://api.textbee.dev/api/v1/gateway/devices/{ID}/get-received-sms",
  { headers: { 'x-api-key': API_KEY } }
);
const messages = await response.json();
// Process messages

Step 5: Advanced Features

Once you've mastered the basics, explore textbee.dev's advanced capabilities to enhance your SMS integration. These features help scale your messaging operations and automate complex workflows.

Bulk SMS: Send to multiple recipients with a single API call for efficient message broadcasting
Webhooks: Configure event-driven notifications for real-time updates on message status
Multiple Devices: Connect several phones to increase throughput and add redundancy

Why Choose textbee.dev SMS Gateway?

Cost-Effective SMS Solution

textbee.dev eliminates the need for expensive SMS API services or telecom contracts. By using your existing phone and mobile plan, you can send SMS messages at standard rates without additional per-message fees from third-party providers.

Easy Integration

Our RESTful API makes integration simple for developers using any programming language. textbee.dev works seamlessly with web applications, mobile apps, and backend services through standard HTTP requests.

Perfect For

Two-factor authentication (2FA) - Secure user accounts with SMS verification codes
Appointment reminders - Reduce no-shows with automated SMS notifications
Order updates - Keep customers informed about their purchases
Marketing campaigns - Engage customers with promotional messages
Alerts and notifications - Send time-sensitive information instantly

Ready to explore more? Check out our use cases page.