Skip to main content

​
Overview

The Telegent mPaaS API gives you programmatic control over the full mobile communications lifecycle — from provisioning and porting phone numbers, to routing voice calls and sending messages, to managing subscribers, accounts, packages, and AI-powered filtering. All requests are made over HTTPS to the base URL:
Responses are JSON and always include a Successful field:

​
Rate Limits

Each distributor is limited to 120 requests per minute, counted across all endpoints. The limit applies API-wide, so requests to any combination of endpoints draw from the same per-minute allowance. When the limit is exceeded, the API responds with HTTP 429 Too Many Requests:
In addition to the API-wide limit, the Number Provision (POST /v1.0/numbers/provision) and Port-In (POST /v1.0/numbers/portin) endpoints are each limited to 1 request per second. This per-endpoint limit applies separately from the 120 requests/minute allowance and also returns HTTP 429 when exceeded. If you consistently reach either limit, contact support to discuss your usage requirements.

​
Quick Start

1

Get Your Credentials

Obtain your AccountKey and AccountSecret from your Telegent representative or the API Portal.
2

Authenticate

Exchange your credentials for a Bearer token via POST /v1.0/oauth2/tokens. See the OAuth2 endpoint for details.
3

Make Your First Call

Include the token in the Authorization header on every request:

​
API Categories

OAuth2

Exchange credentials for a Bearer token

Numbers

Search availability, provision numbers, manage inventory, and configure data usage

Number Porting

Port numbers in or out, check eligibility, and manage port requests

Message

Create message routes, send outbound SMS/MMS, and query message history

Voice

Configure voice routes and manage outbound/inbound call handling

Workgroups

Manage workgroups, activities, and call handling logic

Products, Packages & Subscriptions

Define services and products, bundle into packages, and manage subscriptions

AI Guardian

Configure per-subscriber call and message filters, blocked contacts, and guardian relationships

Accounts & Subscribers

Create and manage accounts, subscribers, aggregators, and distributors

​
Need Help?

Quick Start Guide

Step-by-step authentication and first API call

API Portal

Access the API management console

Support

Visit our support portal for help and resources