Skip to main content
This quickstart walks you through sending your first SMS message using the Trackly SMS API.

​
Prerequisites

A Trackly SMS account with an active API key
A configured sending list with a phone number
A test phone number to receive the message
Don’t have these yet? See the dashboard quickstart first.

​
Step 1: Get Your API Key

  1. Log into the Trackly SMS Dashboard
  2. Go to Settings > API Keys
  3. Copy your API key (or create one if you haven’t)
Keep your API key secret. Never commit it to version control.

​
Step 2: Find Your Sending List ID

  1. Navigate to Lists in the dashboard
  2. Click on your sending list
  3. Copy the Phone Number ID (format: pn_abc123...)

​
Step 3: Send a Message

Choose your preferred language: 
curl -X POST https://app.tracklysms.com/api/v1/messages \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "body": "Hello from Trackly SMS! This is my first message.",
    "from_phone_number_id": "YOUR_PHONE_NUMBER_ID"
  }'

​
Step 4: Check the Response

A successful response looks like: 
{
  "message_id": "msg_xyz789abc123",
  "status": "queued",
  "deprecated": true
}
Your message is now queued and will be delivered within seconds!

​
Common Issues

Your API key is missing or invalid.Solution: Check that you’re including the X-Api-Key header and the key is correct.
The phone number format is incorrect.Solution: Use E.164 format with country code (e.g., +14155551234)
The from_phone_number_id doesn’t exist or isn’t active.Solution: Check the Phone Number ID in your Lists dashboard.
  • Verify the recipient number is correct
  • Check if the number can receive SMS (not a landline)
  • Look for delivery status in the dashboard

​
Next Steps

Send Bulk Messages

Send up to 1,000 messages at once

Build an Audience

Segment your contacts for targeting

Set Up Alerts

Get notified of delivery failures

API Reference

Explore all API endpoints