Skip to main content
The Trackly SMS API allows you to send SMS messages programmatically. Use it to integrate SMS into your applications, automate sends from your systems, or build custom integrations.

​
Base URL

All API requests should be made to: 
https://app.tracklysms.com/api

​
API Versions

The v1 API is deprecated. All v1 endpoints will continue to work but include deprecation headers in responses. Contact support for information about the upcoming v2 API.
VersionStatusNotes
v1DeprecatedCurrent production API
v2Coming SoonEnhanced endpoints and features

​
Authentication

All API requests require authentication using an API key passed in the X-Api-Key header. 
curl -X POST https://app.tracklysms.com/api/v1/messages \
  -H "X-Api-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"to": "+14155551234", "body": "Hello!", "from_phone_number_id": "pn_abc123"}'
See Authentication for details on obtaining and managing API keys.

​
Available Endpoints

Messages

Send single and bulk SMS messages

Contacts

Manage contacts (deprecated, no-op)

Webhooks

Receive delivery status updates

Error Codes

Handle errors gracefully

​
Request Format

  • All requests must include Content-Type: application/json
  • Phone numbers should be in E.164 format (e.g., +14155551234)
  • Request bodies must be valid JSON

​
Response Format

All responses are JSON with a consistent structure: 
{
  "message_id": "msg_xyz789",
  "status": "queued",
  "deprecated": true
}

​
Deprecation Headers

All v1 API responses include these headers:
HeaderValue
X-API-Deprecatedv1 is deprecated
Deprecationtrue

​
Rate Limits

Rate limits are per API key. Contact support if you need higher limits for your use case.
EndpointLimit
Single message100 requests/second
Bulk messages10 requests/second

​
SDKs & Libraries

Currently, we recommend using standard HTTP libraries in your preferred language: 
import requests

response = requests.post(
    "https://app.tracklysms.com/api/v1/messages",
    headers={
        "X-Api-Key": "your_api_key",
        "Content-Type": "application/json"
    },
    json={
        "to": "+14155551234",
        "body": "Hello from Trackly!",
        "from_phone_number_id": "pn_abc123"
    }
)
print(response.json())

​
Next Steps

Authentication

Get your API key

Send Your First Message

Make your first API call