Skip to main content

​
Returns a list of campaigns currently available per creator.

​
Required Scopes: campaigns:read

​
ok
boolean
true on success
​
creatorId
string (uuid)
Echoed back
​
campaigns
string array

child attributes

​
id
string (uuid)
Use for details / activate / analytics
​
brand.imageUrl
string (url)
Brand logo
​
status
string
AVAILABLE, ACTIVATED, or ENDED (creator’s status for this campaign)
​
startsAt
string (date)
YYYY-MM-DD
​
endsAt
string (date) | null
null = open-ended
​
imageUrl
string (url)
Campaign hero image
​
offerCount
number
Total offers across all offer groups
​
locationCount
number
Distinct participating locations
​
total
number
Count of returned campaigns
bash
curl -sS https://api.storytime.io/v1/creators/<creatorId>/campaigns \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
200
{
  "ok": true,
  "creatorId": "7d4e2a10-0000-4000-8000-000000000101",
  "campaigns": [
    {
      "id": "0b1f3d3e-4c1a-4a5e-9b6a-000000000001",
      "name": "Summer Tasting Menu",
      "brand": {
        "id": "a9c8b7d6-0000-4000-8000-000000000201",
        "name": "Marlow & Vine",
        "imageUrl": "https://cdn.storytime.io/uploads/demo-brand-marlow.jpg"
      },
      "status": "AVAILABLE",
      "startsAt": "2026-07-01",
      "endsAt": "2026-07-31",
      "imageUrl": "https://cdn.storytime.io/uploads/demo-summer-tasting.jpg",
      "offerCount": 1,
      "locationCount": 1
    }
  ],
  "total": 1
}