TelcoCloud Documentation

Getting Started

TelcoCloud offers three ways to interact with the platform:

• Web Portal - Manage your account, view usage, and configure settings at telcocloud.io
• CLI - Command-line tool for developers who prefer terminal workflows
• API - Direct HTTP API access for integrating into your applications

Authentication

Web Portal Login

Visit telcocloud.io/login and sign in with your After Dark Systems account via Authentik SSO at adsas.id. Once logged in, you can:

• View your API usage and billing
• Manage phone numbers and webhooks
• Generate and revoke API keys
• Configure account settings

CLI Authentication

The CLI uses OAuth 2.0 to authenticate with your TelcoCloud account:

telcocloud auth login

This command will:

1. Open your browser to https://adsas.id
2. Ask you to authorize the TelcoCloud CLI
3. Automatically receive and save your API key to ~/.config/telcocloud/config.json

After logging in once, all CLI commands will automatically use your saved credentials.

API Authentication

For direct HTTP API access, you need an API key. You can generate one via:

• Web Portal: Go to Settings → API Keys → Generate New Key
• CLI: Run telcocloud auth login - your key is in ~/.config/telcocloud/config.json

Include your API key in the Authorization header of all requests:

curl https://api.telcocloud.io/v1/sms \\
  -H "Authorization: Bearer tc_live_your_api_key" \\
  -H "Content-Type: application/json" \\
  -d '{"to":"+15125551234","body":"Hello!"}'

API Key Format:

• tc_test_... - Test mode keys (free, no actual SMS sent)
• tc_live_... - Production keys (charges apply)

CLI Installation

Install via Package Manager

Install the TelcoCloud CLI using your preferred package manager:

# Via npm
npm install -g telcocloud-cli

# Via curl
curl -sSL https://telcocloud.io/install.sh | bash

# Via Homebrew
brew install telcocloud/tap/telcocloud

Verify Installation

Check that the CLI is installed correctly:

telcocloud --version
telcocloud --help

Check Authentication Status

See which account you're currently authenticated as:

telcocloud auth whoami

Output will show your email, username, and API key prefix.

Using the Web Portal

Dashboard

After logging in, the dashboard shows:

• Usage Overview - SMS sent, numbers provisioned, verifications performed
• Recent Activity - Latest API calls and their status
• Quick Actions - Send test SMS, search numbers, view logs

Managing API Keys

In Settings → API Keys you can:

• Generate new API keys (test or production)
• View key prefixes and creation dates
• Revoke compromised keys
• Set key-specific rate limits

Phone Numbers

The Numbers page allows you to:

• Search available numbers by area code or prefix
• Purchase numbers instantly
• Configure forwarding and webhooks per number
• Release unused numbers

API Reference

SMS API

Send SMS messages globally with delivery receipts via webhooks.

# CLI
telcocloud sms send +15125551234 "Hello from TelcoCloud!"

# HTTP
POST https://api.telcocloud.io/v1/sms
{
  "to": "+15125551234",
  "body": "Hello from TelcoCloud!"
}

Response:

{
  "id": "msg_abc123",
  "to": "+15125551234",
  "status": "sent",
  "created_at": "2026-02-27T08:30:00Z"
}

Phone Numbers

Provision local and toll-free numbers instantly.

# Search available numbers
telcocloud numbers search --area-code 512

# Purchase a number
telcocloud numbers buy +15125559001

HTTP API:

GET https://api.telcocloud.io/v1/numbers/available?area_code=512

POST https://api.telcocloud.io/v1/numbers
{
  "phone_number": "+15125559001"
}

Verification

Send OTP codes and verify phone numbers.

# Send verification code
telcocloud verify send +15125551234

# Check verification
telcocloud verify check +15125551234 123456

HTTP API:

POST https://api.telcocloud.io/v1/verify/send
{
  "phone_number": "+15125551234"
}

POST https://api.telcocloud.io/v1/verify/check
{
  "phone_number": "+15125551234",
  "code": "123456"
}

SDKs and Libraries

Official SDKs are available for popular languages:

# Node.js
npm install @telcocloud/node

# Python
pip install telcocloud

# Go
go get github.com/afterdarksys/telcocloud-go

Node.js Example

import TelcoCloud from '@telcocloud/node';

const client = new TelcoCloud('tc_live_your_api_key');

await client.sms.send({
  to: '+15125551234',
  body: 'Hello from Node.js!'
});

Webhooks

Configure webhooks to receive delivery receipts and incoming messages:

# Set webhook URL
telcocloud webhooks set https://yourdomain.com/webhook

# Test webhook
telcocloud webhooks test

Webhook Payload

{
  "event": "message.delivered",
  "message_id": "msg_abc123",
  "to": "+15125551234",
  "status": "delivered",
  "timestamp": "2026-02-27T08:30:00Z"
}

Rate Limits

API rate limits are based on your subscription tier:

• Free tier: 100 requests/minute
• Pro tier: 1,000 requests/minute
• Enterprise: Custom limits

Error Handling

All errors return standard HTTP status codes with JSON error messages:

{
  "error": {
    "code": "invalid_phone_number",
    "message": "The phone number format is invalid",
    "param": "to"
  }
}

Support

Need help? Here's how to get support:

• GitHub: afterdarksys/telcocloud-cli
• Status: status.telcocloud.io
• Email: support@afterdarksys.com

npm install -g telcocloud-cli
telcocloud auth login