Back to home
Setup Guide

Get started with SmsSync

From signup to receiving your first webhook — follow these steps to turn your Android phone into an SMS gateway in under 5 minutes.

Before you start — understand the two URLs

Server URLOUR SERVER

This is SmsSync's server. You enter this in the Flutter app so your phone knows where to send SMS data.

https://smssync.dev

You get this URL when you register. It's the same for everyone.

Webhook URLYOUR SERVER

This is your own server. You add this in the dashboard so SmsSync knows where to forward the SMS data.

https://your-api.com/webhook

This is your backend endpoint that receives the SMS JSON payload.

1

Create your account

smssync.dev/register

Sign up with your email and password. You'll instantly get an API key — this is how your phone authenticates with our server.

What you get

  • Account with unique API key
  • Access to the web dashboard
  • Free plan with webhook support
smssync.dev/register

Create Account

John Doe
john@example.com
••••••••••
Your API Key (save this!):
smssync_a8f2e9d1c4b7...
2

Install the SmsSync app

Your Android phone

Download and install the SmsSync APK on the Android phone that will receive the SMS. Grant SMS permissions when prompted.

What you get

  • SMS listening in background
  • Works even when phone is locked
  • Supports dual SIM
9:41
5G
SmsSync

SmsSync

SMS Gateway for your server

SMS Permission granted
Phone Permission granted
Battery optimization disabled

App needs these permissions to listen for SMS in the background

3

Configure the app

SmsSync app → Settings

Open the app, tap Settings, and enter your Server URL and API Key. The Server URL is our server — this is where your phone sends the SMS data. The API Key identifies your account.

What you get

  • Phone connected to your SmsSync account
  • Real-time SMS forwarding enabled
  • Device shows up in your dashboard
9:41
5G
Settings
https://smssync.dev
This is OUR server — SmsSync's backend
smssync_a8f2e9d1c4b7...
From your dashboard settings page
MoMo Phone
Connected to server successfully!
4

Add your webhook

smssync.dev/dashboard/webhooks

Go to Webhooks in your dashboard and add your server's endpoint URL. This is YOUR server — the place where you want to receive the SMS data. You can add multiple webhooks.

What you get

  • SMS forwarded to your server as JSON
  • Optional HMAC signing for security
  • Delivery tracking with retry on failure
smssync.dev/dashboard/webhooks

Webhooks

New Webhook
My Payment Server
https://your-api.com/webhook
This is YOUR server endpoint
My Payment ServerACTIVE
https://your-api.com/webhook
24 delivered0 failed
5

Receive SMS on your server

Your backend

That's it! Every SMS your phone receives will now be stored in the cloud AND sent to your webhook. You get the raw sender ID and full message content to process however you need.

What you get

  • Real-time SMS data via POST request
  • Full message history in your dashboard
  • Cloud backup even if phone SMS is deleted
POST https://your-api.com/webhook200 OK
Request Body:
{
  "event": "sms.received",
  "timestamp": 1709640000000,
  "data": {
    "sender": "MobileMoney",
    "content": "You have received GHS 150.00...",
    "receivedAt": "2026-03-05T12:00:00Z",
    "sim": "SIM1",
    "deviceId": "pixel_7a"
  }
}
Also visible in your dashboard at smssync.dev
MobileMoneyDELIVEREDJust now

You have received GHS 150.00 from JOHN DOE 0244xxxxxx...

Message stored permanently — even if deleted from phone

Quick Summary

1
Register
smssync.dev
2
Copy API Key
Dashboard → Settings
3
Install App
Android phone
4
Add Webhook
Dashboard → Webhooks
5
Receive SMS
On your server

Ready to get started?

Create your free account and start forwarding SMS in under 5 minutes.