Build your own on the SMS Activate App API

Guides for a Telegram bot, a local dashboard, a home-screen app, a website, a number farm or a Claude Code workspace on your numbers.

Everything the bot, the app and the website do with your numbers is also open to you through the API: search and buy numbers, read SMS and call recordings with their codes, release numbers, see the balance and top it up, and get every SMS pushed to your own server. These guides turn that into a setup of your own, built with Claude Code in minutes.

Start here: copy the one prompt into Claude Code. Or pick a setup and download its guide: each one is a brief Claude Code can follow on its own.

  • Setup · What you get · Guide
  • Telegram bot · Your own bot: your numbers, codes the moment they arrive, buying in a chat · telegram-bot.md
  • Local dashboard · A page on your computer with every number, SMS and code, live · dashboard.md
  • Home-screen app · An app on your phone that works without Telegram · app.md
  • Website · Your own site on top of the API, with your own design · website.md
  • Number farm · Many numbers under one key: bought, labelled, renewed and read in bulk · farm.md
  • Claude Code workspace · Claude Code that manages your numbers when you ask it in plain words · claude-code.md

What every setup needs

  • An API key. In the Telegram bot @PrivatePhoneBot open the menu «🔑 API Keys» and create one, or

create it on the website after signing in. It looks like vpn_…. Treat it like a password.

  • A balance. Numbers are paid from your account balance. Top it up on the website, in the app or

in the bot.

  • Claude Code, or any developer who can read a short brief.

The API in one screen

  • Base URL https://api.sms-activate.app/v1/public, header Authorization: Bearer <your key>.
  • GET /countries, GET /numbers/search?country=US, POST /numbers (buy, send an Idempotency-Key),

GET /numbers, GET /numbers/:id/sms, GET /sms, DELETE /numbers/:id (release), GET /balance.

  • Push instead of polling: set a webhook URL with PATCH /v1/me {"webhookUrl": "https://…"} and every

SMS and call recording is POSTed to you, signed.

  • Money in responses is integer cents. Full reference: https://sms-activate.app/api

Why build your own

Your numbers stay within reach whatever happens to one app or one messenger: the key works from any setup you build, and you can run several at once.