Developers

The mobile network, as an API.

One versioned REST API for numbers, voice, SMS, MMS, RCS, and data. Provision a real U.S. carrier number, send a text, or place a call from the same SDK, with real-time webhooks and deliverability handled for you.

Read the docs Book a demo

Quickstart

From key to first message in minutes.

Install the SDK, drop in your key, and you are talking to the carrier network. Here are the three calls you will reach for first. REST is available for everything the SDK does.

provision-number.ts

// Claim a local U.S. mobile number
import { Telegent } from '@telegent/sdk';

const tg = new Telegent(process.env.TELEGENT_KEY);

const number = await tg.numbers.provision({
  type: 'mobile',
  areaCode: '801',
  capabilities: ['voice', 'sms', 'mms'],
});

console.log(number.msisdn); // +18015550142

send-sms.ts

// Send an SMS from that number
const message = await tg.messages.send({
  from: '+18015550142',
  to: '+13105550188',
  text: 'Your line is live on Telegent',
});

console.log(message.status); // queued

// Same call over REST:
// POST /v1/messages
// Authorization: Bearer $TELEGENT_KEY

inbound-webhook.ts

// Handle an inbound message event
export async function POST(req: Request) {
  const event = await tg.webhooks.verify(req);

  if (event.type === 'message.received') {
    await tg.messages.send({
      from: event.data.to,
      to: event.data.from,
      text: 'Got it, thanks!',
    });
  }

  return new Response(null, { status: 200 });
}

Built for builders

Everything the carrier does, exposed as software.

A clean, modern surface over real U.S. mobile infrastructure. The messy parts, deliverability, compliance, and carrier routing, are handled so you can stay in your editor.

One API

Numbers, voice, SMS, MMS, RCS, and data behind a single, coherent REST surface. Learn one model, ship the whole stack.

Real-time webhooks & events

Subscribe to inbound messages, call state, and delivery receipts. Signed payloads arrive in milliseconds, not minutes.

SDKs for your stack

First-party SDKs for TypeScript and Python, with Go and Ruby in preview. Typed clients, sane defaults, no boilerplate.

RCS & MMS built in

Rich cards, media, and read receipts alongside plain SMS. One send call, graceful fallback across every carrier.

A2P registration handled

Brand and campaign registration is managed for you, so your throughput and deliverability stay carrier-grade.

Idempotent & versioned

Every write takes an idempotency key and every request is pinned to a date-based API version. Upgrade on your terms.

API reference

A tour of the endpoints.

A small, tasteful sample of the surface. The paths below are illustrative. See the full, versioned reference in the docs for parameters, responses, and every resource.

POST /v1/numbers

Provision a number

Search and claim a local or toll-free U.S. mobile number, ported or net-new, ready to route in seconds.

POST /v1/messages

Send a message

Deliver SMS, MMS, or RCS from a Telegent number, with automatic fallback and delivery receipts.

POST /v1/calls

Place a call

Originate a native mobile call that carries your business identity, with recording and routing control.

GET /v1/calls/live

Stream live calls

List calls currently in progress and watch state transitions in real time for dashboards and routing.

POST /v1/webhooks

Register a webhook

Point message and call events at your endpoint. Payloads are signed so you can verify every delivery.

Endpoints shown are illustrative. Refer to the docs for the authoritative, versioned reference.

Start building on the network.

Provision a real U.S. carrier number and send your first message today. Book a demo, or dive straight into the docs.

Book a demo Read the docs