Skip to main content
GET
/
v2
/
creatives
curl -X GET "https://api.tracklysms.com/api/v2/creatives?status=active&creative_type=automated&page=1&per_page=25" \
  -H "X-Api-Key: trk_your_api_key_here"
{
  "creatives": [
    {
      "id": 101,
      "name": "Summer Sale Promo",
      "message": "Hot deals just for you! Shop now: {{link1}} Reply STOP to opt out.",
      "offer_links": [
        {
          "key": "link1",
          "offer_id": "offer_abc123",
          "url": null,
          "url_params": {"sub1": "sms"}
        }
      ],
      "offers": ["offer_abc123"],
      "status": "active",
      "creative_type": "automated",
      "character_count": 97,
      "segment_count": 1,
      "created_at": "2025-06-10T12:00:00Z"
    },
    {
      "id": 102,
      "name": "New Arrivals Alert",
      "message": "Check out what just dropped: {{link1}} See more: {{link2}} Reply STOP to opt out.",
      "offer_links": [
        {
          "key": "link1",
          "offer_id": "offer_def456",
          "url": null,
          "url_params": {}
        },
        {
          "key": "link2",
          "offer_id": "offer_ghi789",
          "url": "https://example.com/new",
          "url_params": {}
        }
      ],
      "offers": ["offer_def456", "offer_ghi789"],
      "status": "active",
      "creative_type": "automated",
      "character_count": 120,
      "segment_count": 1,
      "created_at": "2025-06-12T08:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 2,
    "total_pages": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.tracklysms.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns all creatives for your account with support for filtering by status and creative type. Results are paginated.

Query Parameters

status
string
default:"active"
Filter creatives by status. Accepted values: active, paused, archived.
creative_type
string
Filter creatives by type. Accepted values: automated, one_time, welcome. When omitted, all types are returned.
page
integer
default:1
The page number to return.
per_page
integer
default:50
Number of creatives per page. Maximum: 100.

Response Fields

creatives
array
Array of creative objects.
pagination
object
Pagination metadata.

Examples

curl -X GET "https://api.tracklysms.com/api/v2/creatives?status=active&creative_type=automated&page=1&per_page=25" \
  -H "X-Api-Key: trk_your_api_key_here"
{
  "creatives": [
    {
      "id": 101,
      "name": "Summer Sale Promo",
      "message": "Hot deals just for you! Shop now: {{link1}} Reply STOP to opt out.",
      "offer_links": [
        {
          "key": "link1",
          "offer_id": "offer_abc123",
          "url": null,
          "url_params": {"sub1": "sms"}
        }
      ],
      "offers": ["offer_abc123"],
      "status": "active",
      "creative_type": "automated",
      "character_count": 97,
      "segment_count": 1,
      "created_at": "2025-06-10T12:00:00Z"
    },
    {
      "id": 102,
      "name": "New Arrivals Alert",
      "message": "Check out what just dropped: {{link1}} See more: {{link2}} Reply STOP to opt out.",
      "offer_links": [
        {
          "key": "link1",
          "offer_id": "offer_def456",
          "url": null,
          "url_params": {}
        },
        {
          "key": "link2",
          "offer_id": "offer_ghi789",
          "url": "https://example.com/new",
          "url_params": {}
        }
      ],
      "offers": ["offer_def456", "offer_ghi789"],
      "status": "active",
      "creative_type": "automated",
      "character_count": 120,
      "segment_count": 1,
      "created_at": "2025-06-12T08:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 2,
    "total_pages": 1
  }
}

Error Codes

HTTP StatusError CodeDescription
401unauthorizedAPI key is missing or invalid.
400invalid_statusThe provided status value is not one of the accepted values.
400invalid_creative_typeThe provided creative_type value is not one of the accepted values.

Next Steps

Creative Templates

Design effective message templates

Create Schedule

Use creatives in a scheduled campaign