Phone Agent - Your Phone, Your Send-Only Messaging API

Get Started

Account first, then install, then scan your Config QR.

Sign in or create a free account

Your free plan is created automatically. This account is used later to generate the Config QR for the phone.

Plan is attached to the account

Free works immediately with limits. Upgrade later only if you need more volume. No setup code is needed in the normal flow.

View Plans

Install Phone Agent

Scan the Install QR with the phone. It downloads the APK; tap the downloaded file to install. Install does not configure the app.

Download App

Generate and scan Config QR

Open Setup while logged in, click Generate QR, then scan it with the installed app. Two things happen:

The app saves server, phone, key, and license values automatically.
The app validates the account/license at runtime before messaging.

Open Setup

Send your first message

POST to /api/v1/messages with your account API key as a Bearer token. Edit the curl below, copy it for your terminal, or send it straight from this page:

Editable curl — replace YOUR_CLIENT_API_KEY and to.

Put your own number in to for a self-test. See code samples for Python, Node, Go, Java, C#. Need bulk + scheduling? Business Hub.

Full HTTP API Docs

One API, every channel

Your phone delivers — you choose the channel per request.

SMS

Real carrier SMS via your SIM plan.

Send through the WhatsApp app on your phone.

Send through the Telegram app on your phone.

Email

Send transactional email via configured account.

Push Notify

Local notifications on your phone for alerts.

Why Phone Agent

Your phone becomes a message API

Phone Agent turns your mobile phone into a message-forwarding API. Your website, app, bot, or internal system triggers messages while the connected phone remains the sender.

Send from code, through the phone

Your code triggers the message. The Android phone sends it through SMS, WhatsApp, Telegram, email, or local notify, depending on the channel.

Useful for real systems

A site can route order updates, reminders, alerts, support messages, daily summaries, and AI-assistant actions through one connected phone.

Fan out one alert to many people

Receive one event from your system, then broadcast it to several users, for example sending the same outage alert to 10 team members.

Use your own SIM plan

No per-message SMS provider lock-in. Your existing mobile plan and phone accounts stay in control.

Send-only and private

Messages flow from your system to your phone to the recipient. The connected phone is the delivery endpoint.

Drop into any workflow

Use WebChat for manual sends, Business Hub for bulk work, or the API when your software needs to send automatically.

Built for Developers

Simple REST endpoints. Bearer-token auth. Copy/paste examples in every major language.

Tap a language to see a copy-paste example. Default URL is the hosted relay https://phonerelay.dev — override only for private deployments.

Python

import requests

requests.post(
    "https://phonerelay.dev/api/v1/messages",
    headers={"Authorization": "Bearer YOUR_CLIENT_API_KEY"},
    json={"channel": "sms", "to": "+1234567890", "text": "Hello from Phone Agent"},
)

Node.js

await fetch("https://phonerelay.dev/api/v1/messages", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_CLIENT_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    channel: "sms",
    to: "+1234567890",
    text: "Hello from Phone Agent",
  }),
});

Go

body := strings.NewReader(`{"channel":"sms","to":"+1234567890","text":"Hello"}`)
req, _ := http.NewRequest("POST", "https://phonerelay.dev/api/v1/messages", body)
req.Header.Set("Authorization", "Bearer YOUR_CLIENT_API_KEY")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)

Java

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://phonerelay.dev/api/v1/messages"))
    .header("Authorization", "Bearer YOUR_CLIENT_API_KEY")
    .header("Content-Type", "application/json")
    .POST(BodyPublishers.ofString(
        "{\"channel\":\"sms\",\"to\":\"+1234567890\",\"text\":\"Hello\"}"))
    .build();
HttpClient.newHttpClient().send(req, BodyHandlers.ofString());

C# / .NET

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "YOUR_CLIENT_API_KEY");
var body = new StringContent(
    "{\"channel\":\"sms\",\"to\":\"+1234567890\",\"text\":\"Hello\"}",
    Encoding.UTF8, "application/json");
await http.PostAsync("https://phonerelay.dev/api/v1/messages", body);

cURL / C++ / Rust

curl -X POST https://phonerelay.dev/api/v1/messages \
  -H "Authorization: Bearer YOUR_CLIENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"sms","to":"+1234567890","text":"Hello"}'

Send to yourself, or anyone

The to: field is the recipient. Put your own number in there and your phone delivers the SMS to yourself — handy for personal alerts, trade signals, deploy notifications, or just smoke-testing the API.

Channel	`to:` value	Other params
`sms`	E.164 phone number, e.g. `+1234567890` (your own works)	—
`wa`	Phone number (must be installed in WhatsApp)	—
`tg`	Phone number or `@username`	—
`tg_bot`	Telegram `chat_id`	`bot_token` required
`email`	Email address (your own or anyone)	`subject` required
`notify`	(not used) — local notification on your own phone	optional `title`

Channels: SMS, WhatsApp (wa), Telegram (tg), Telegram bot (tg_bot), email, and local push (notify). The notify channel is self-only by design — it shows a local Android notification on the connected phone, no carrier message sent.

Open HTTP API Docs

Download

1. Install Phone Agent

Scan the Install QR with the phone. The phone downloads phone-agent.apk; tap the downloaded file to install. Install alone does not connect the app.

Before generating the Config QR, sign in or create a free account. Keep the phone connected to the internet.

Manual Download APK

Install QR

Scan on the phone. Download starts in the phone browser. Tap the downloaded APK and allow install from this source if Android asks.

Manual download / transfer from PC

If you cannot scan the QR, click Manual Download APK, move the APK to the phone, then open it on the phone to install. Optional checksum: SHA256SUMS.txt.

Install blocked on Android?

Open Google Play Store on the phone.
Tap your account icon at the top-right (profile menu).
Tap Play Protect.
Tap the gear icon (top-right), then temporarily disable Scan apps with Play Protect.
Open Settings -> Apps -> (Chrome or Files) -> Install unknown apps -> Allow, install APK, then re-enable Play Protect scan.

Seeing "App not installed"?

Confirm installer source is allowed: Settings -> Apps -> (Chrome or Files) -> Install unknown apps -> Allow.
Remove older conflicting app build, then retry.
Ensure enough free storage on phone.

App installed but access is blocked?

Re-check Install unknown apps allowance for Files/Chrome.
For WhatsApp/Telegram auto-send, open Settings -> Apps -> Phone Agent -> three-dot menu -> Allow restricted settings.
Then open Accessibility -> Installed apps and enable the Phone Agent auto-send services.

ADB install fallback (PC)

If file copy from PC is blocked, use:

adb devices
adb install -r phone-agent.apk

Optional helper aliases:

source ./phoneagent-apk-aliases.sh
pa-apk-devices
pa-apk-install phone-agent.apk
pa-apk-setup

If you get INSTALL_FAILED_UPDATE_INCOMPATIBLE:

adb uninstall com.agentphone.app
adb install phone-agent.apk

If adb devices shows nothing:

Enable Developer options + USB debugging on phone.
Accept the RSA prompt on phone.
Re-run adb devices.

2. Connect Phone

After Phone Agent is installed and you are signed in, open the setup page. Click Generate QR, then scan the Config QR with the phone.

Open Setup Page

Turn Your Phone Into a Messaging API in 5 Minutes