#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

Before you get started, make sure you have the following:

• 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 you can order a prebuilt device here.

#Register on Taratxt

1. Visit https://app.taratxt.com
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)

Here's how to send an SMS using PHP and cURL:

<?php

$apiKey = 'your_api_token_here';

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

$ch = curl_init('https://api.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 responsible of sending or receiving the message
   • Number
   • Status
   • Type
   • Message content

*You can also fetch these messages programmatically via the API if needed.