Skip to main content
GET
/
v2
/
creatives
/
{id}
curl -X GET "https://app.tracklysms.com/api/v2/creatives/101" \
  -H "X-Api-Key: trk_your_api_key_here"

{
  "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"
}
Returns the full details of a single creative, including its message template, offer links, and calculated segment count.

​
Path Parameters

​
id
integer
required
The unique identifier of the creative.

​
Response Fields

​
id
integer
Unique identifier for the creative.
​
name
string
Display name of the creative.
​
message
string
The message template with {{linkN}} placeholders.
​
offer_links
array
Array of offer link objects that map to placeholders in the message.
​
offers
array
Array of offer ID strings referenced by this creative.
​
status
string
Current status. One of: active, paused, archived.
​
creative_type
string
The type of creative. One of: automated, one_time, welcome.
​
character_count
integer
Estimated character count of the rendered message. Link placeholders are estimated as 23 characters each, plus 34 characters of compliance overhead.
​
segment_count
integer
Estimated number of SMS segments. 1 if total characters are 160 or fewer; otherwise ceil(total / 153).
​
created_at
datetime
ISO 8601 timestamp of when the creative was created.

​
Examples

curl -X GET "https://app.tracklysms.com/api/v2/creatives/101" \
  -H "X-Api-Key: trk_your_api_key_here"

{
  "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"
}

​
Error Codes

HTTP StatusError CodeDescription
401unauthorizedAPI key is missing or invalid.
404not_foundNo creative exists with the given ID.

​
Next Steps

Creative Templates

Design effective templates

Create Schedule

Use creatives in campaigns