curl -X POST https://api.tracklysms.com/api/v2/links/shorten \
  -H "X-Api-Key: trk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/landing-page",
    "listId": 42
  }'

import requests

response = requests.post(
    "https://api.tracklysms.com/api/v2/links/shorten",
    headers={
        "X-Api-Key": "trk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "url": "https://example.com/landing-page",
        "listId": 42,
    },
)

data = response.json()
print(data["shortUrl"])  # e.g. https://yourdomain.com/Ab3kX9q

const response = await fetch("https://api.tracklysms.com/api/v2/links/shorten", {
  method: "POST",
  headers: {
    "X-Api-Key": "trk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://example.com/landing-page",
    listId: 42,
  }),
});

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

{
  "shortUrl": "https://yourdomain.com/Ab3kX9q",
  "linkId": "Ab3kX9q",
  "destinationUrl": "https://example.com/offer?aff_sub=12345",
  "domain": "https://yourdomain.com",
  "offerId": "6651a3ef1234567890abcdef",
  "filterBots": false
}

{
  "error": "url or offerId is required",
  "code": "missing_url_or_offer"
}

{
  "error": "URL must use http or https scheme",
  "code": "invalid_url_scheme"
}

{
  "error": "metadata cannot exceed 10 keys",
  "code": "invalid_metadata"
}

{
  "error": "Blocked URL: resolves to a private IP address",
  "code": "unsafe_url"
}

{
  "error": "Offer not found",
  "code": "offer_not_found"
}

{
  "error": "No link domain configured for this list",
  "code": "no_domain_configured"
}