Taratxt logo

Getting Started

Create an account, generate a token, and send your first SMS.

Create Account Docs Home

Welcome to Taratxt

Taratxt is a free-to-use IoT SMS Gateway platform that allows you to send and receive SMS messages via your own gateway device. With our easy-to-use API, you can seamlessly integrate SMS functionality into your apps, services, or backend systems.

Requirements

  • A Taratxt account (register at taratxt.com/app)
  • Basic knowledge of PHP or any language of your choice
  • A working internet connection
  • (Later) An ESP32 + GSM module, or order a prebuilt device

Register on Taratxt

  1. Visit https://taratxt.com/app
  2. Click Sign Up and create your free account
  3. Verify your email and log in to your dashboard

Create Your API Token

  1. From this documentation page click back
  2. Click Edit Profile in the sidebar
  3. Click Generate Token
  4. Copy and securely store your API Token — you’ll use this in your system integration

Send an SMS from Your System (PHP Example)

<?php

$apiKey = 'your_api_token_here';

$data = [
    'to' => '+639XXXXXXXXX',
    'message' => 'Hello from Taratxt!',
];

$ch = curl_init('https://taratxt.com/api/send');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey,
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);

echo $response;

*Make sure to replace your_api_token_here and the phone number with real values.

View Messages

  1. From this documentation page click back
  2. Click on Messages in the sidebar
  3. All outgoing received through the API and inbound SMS messages received by your connected device(s) will appear here.
  4. Messages include: Device, Number, Status, Type, Message content

Test Webhooks for Incoming Messages

When your device receives SMS messages, Taratxt can forward them to your webhook endpoint in real-time. To quickly test and debug your webhook integration, try SnapWebhook — a free tool to instantly inspect incoming webhook payloads.

  1. Visit snapwebhook.com and generate a unique webhook URL
  2. Configure this URL in your Taratxt device settings as your webhook endpoint
  3. Send an SMS to your gateway device and watch it appear in SnapWebhook in real-time