Send Raw Single Message

curl -X POST https://api.tracklysms.com/api/v2/send-raw \
  -H "X-Api-Key: trk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "list_number": "+18005551000",
    "body": "URGENT: Your verification code is 482901. Ref: {{messageId}}",
    "skip_duplicate_check": true,
    "skip_rate_limit": true
  }'

import requests

response = requests.post(
    "https://api.tracklysms.com/api/v2/send-raw",
    headers={
        "X-Api-Key": "trk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "to": "+14155551234",
        "list_number": "+18005551000",
        "body": "URGENT: Your verification code is 482901. Ref: {{messageId}}",
        "skip_duplicate_check": True,
        "skip_rate_limit": True,
    },
)

data = response.json()
print(data["message_id"])

const response = await fetch("https://api.tracklysms.com/api/v2/send-raw", {
  method: "POST",
  headers: {
    "X-Api-Key": "trk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+14155551234",
    list_number: "+18005551000",
    body: "URGENT: Your verification code is 482901. Ref: {{messageId}}",
    skip_duplicate_check: true,
    skip_rate_limit: true,
  }),
});

const data = await response.json();
console.log(data.message_id);

{
  "success": true,
  "message_id": "x7y8z9w0",
  "status": "queued"
}

{
  "error": "Invalid recipient phone number format",
  "code": "invalid_phone"
}

POST

send-raw

curl -X POST https://api.tracklysms.com/api/v2/send-raw \
  -H "X-Api-Key: trk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "list_number": "+18005551000",
    "body": "URGENT: Your verification code is 482901. Ref: {{messageId}}",
    "skip_duplicate_check": true,
    "skip_rate_limit": true
  }'

import requests

response = requests.post(
    "https://api.tracklysms.com/api/v2/send-raw",
    headers={
        "X-Api-Key": "trk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "to": "+14155551234",
        "list_number": "+18005551000",
        "body": "URGENT: Your verification code is 482901. Ref: {{messageId}}",
        "skip_duplicate_check": True,
        "skip_rate_limit": True,
    },
)

data = response.json()
print(data["message_id"])

const response = await fetch("https://api.tracklysms.com/api/v2/send-raw", {
  method: "POST",
  headers: {
    "X-Api-Key": "trk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+14155551234",
    list_number: "+18005551000",
    body: "URGENT: Your verification code is 482901. Ref: {{messageId}}",
    skip_duplicate_check: true,
    skip_rate_limit: true,
  }),
});

const data = await response.json();
console.log(data.message_id);

{
  "success": true,
  "message_id": "x7y8z9w0",
  "status": "queued"
}

{
  "error": "Invalid recipient phone number format",
  "code": "invalid_phone"
}

Send a single SMS message. This endpoint accepts a set of skip_* flags intended for granular control over validation and rate-limiting behavior.

The skip_* flags are currently accepted but have no effect. The endpoint does not read them, so every check runs regardless of what you pass. Until the flags are wired up, this endpoint behaves the same as POST /v2/send except that it does not perform link wrapping or contact-data macro substitution.

The following checks are always enforced:

Your account must own the sending list
Phone numbers must be in E.164 format
Your account must be in active status

Body Parameters

string

required

Recipient phone number in E.164 format (e.g. +14155551234).

string

required

Sending list phone number in E.164 format. Must belong to your account.

string

required

Message body text. Use the {{messageId}} placeholder to insert the unique message ID into the body at send time.

boolean

default:"false"

Intended to skip the duplicate message check. Currently accepted but ignored — this flag has no effect.

boolean

default:"false"

Intended to skip per-list rate limiting. Currently accepted but ignored — this flag has no effect.

boolean

default:"false"

Intended to skip contact validation such as opt-out and block list checks. Currently accepted but ignored — this flag has no effect.

boolean

default:"false"

Intended to skip the journey enrollment check. Currently accepted but ignored — this flag has no effect.

object

Optional key-value metadata dictionary. Currently accepted but not stored or returned — the endpoint discards this field, so it cannot yet be used to correlate messages with your own systems.

Response Fields

boolean

Whether the message was successfully queued.

string

An opaque, variable-length message identifier for tracking delivery and clicks.

string

Current message status. Will be "queued" on successful submission.

Examples

curl -X POST https://api.tracklysms.com/api/v2/send-raw \
  -H "X-Api-Key: trk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155551234",
    "list_number": "+18005551000",
    "body": "URGENT: Your verification code is 482901. Ref: {{messageId}}",
    "skip_duplicate_check": true,
    "skip_rate_limit": true
  }'

import requests

response = requests.post(
    "https://api.tracklysms.com/api/v2/send-raw",
    headers={
        "X-Api-Key": "trk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "to": "+14155551234",
        "list_number": "+18005551000",
        "body": "URGENT: Your verification code is 482901. Ref: {{messageId}}",
        "skip_duplicate_check": True,
        "skip_rate_limit": True,
    },
)

data = response.json()
print(data["message_id"])

const response = await fetch("https://api.tracklysms.com/api/v2/send-raw", {
  method: "POST",
  headers: {
    "X-Api-Key": "trk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+14155551234",
    list_number: "+18005551000",
    body: "URGENT: Your verification code is 482901. Ref: {{messageId}}",
    skip_duplicate_check: true,
    skip_rate_limit: true,
  }),
});

const data = await response.json();
console.log(data.message_id);

{
  "success": true,
  "message_id": "x7y8z9w0",
  "status": "queued"
}

{
  "error": "Invalid recipient phone number format",
  "code": "invalid_phone"
}

Error Codes

HTTP Status	Error Code	Description
400	`missing_to`	The `to` field is required but was not provided.
400	`missing_list_number`	The `list_number` field is required but was not provided.
400	`missing_body`	The `body` field is required but was not provided.
400	`invalid_phone`	The `to` field is not a valid E.164 phone number.
400	`invalid_list_number`	The `list_number` field is not a valid E.164 phone number.
400	`list_not_found`	The sending list was not found or does not belong to your account.
400	`webhook_not_configured`	Webhook verification required before sending (BYOC lists).
400	`pending_confirmation`	The recipient has not confirmed their double opt-in yet, so they cannot be messaged.
400	`doi_expired`	The recipient never confirmed their double opt-in and the confirmation window has expired.
400	`warmup_limit`	The recipient is not yet eligible to be messaged under the list’s warm-up schedule.
502	`kafka_producer_failure`	The message could not be queued for delivery (transient). The 502 body includes `errorCode: "KAFKA_PRODUCER_FAILURE"`; retry with backoff.

Authenticated requests can also fail with 401 invalid_credentials, 403 account_suspended, or 429 rate_limited — see Error Codes.

API Reference

V2 API Reference

Partner Accounts (v2)

Messages (v2)

Contacts (v2)

Lists (v2)

Number Requests (v2)

Business Profiles (v2)

Creatives (v2)

Audiences (v2)

Offers (v2)

Schedules (v2)

Revenue (v2)

Usage & Billing (v2)

Data Import (v2)

Links (v2)

Clicks (v2)

Webhooks (v2)

Phone Validation (v1)

API Reference (v1 - Deprecated)

Send Raw Single Message

Body Parameters

Response Fields

Examples

Error Codes

Next Steps

Campaign Execution

Create Contact

​Body Parameters

​Response Fields

​Examples

​Error Codes

​Next Steps

Campaign Execution

Create Contact

Body Parameters

Response Fields

Examples

Error Codes

Next Steps