Available Campaigns

Returns a list of campaigns currently available per creator.

Required Scopes: `campaigns:read`

boolean

true on success

string (uuid)

Echoed back

string array

child attributes

string (uuid)

Use for details / activate / analytics

string (url)

Brand logo

string

AVAILABLE, ACTIVATED, or ENDED (creator’s status for this campaign)

string (date)

YYYY-MM-DD

string (date) | null

null = open-ended

string (url)

Campaign hero image

number

Total offers across all offer groups

number

Distinct participating locations

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
}

Authentication

Campaign

Troubleshooting

Returns a list of campaigns currently available per creator.

Required Scopes: `campaigns:read`

​Returns a list of campaigns currently available per creator.

​Required Scopes: campaigns:read

Returns a list of campaigns currently available per creator.

Required Scopes: `campaigns:read`