Campaigns

List campaign activity

Returns a page of creative adds, creative pause/resume (user request or Meta sync), budget changes, tier updates, country updates, playlist redirect heals, and auto-renew changes for one campaign.

Each item is an event type, a timestamp, and a short summary. Replacing a creative appears as a pause of the old creative plus CAMPAIGN_AD_CREATIVES_ADDED for the new one. The list does not include campaign creation. Fee amounts, Stripe ids, and internal file URIs are omitted.

startDate keeps events at or after that moment. A calendar date starts at 00:00:00Z. Omit it to page through the full history. Any waiting rule, such as 72 hours after a change, is applied by the caller.

Requires the campaigns:read scope. Accepts API key or OAuth Bearer.

GET

campaigns

{campaignId}

activity

List campaign activity

curl --request GET \
  --url https://api.getsoundlink.com/v1/campaigns/{campaignId}/activity \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.getsoundlink.com/v1/campaigns/{campaignId}/activity"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getsoundlink.com/v1/campaigns/{campaignId}/activity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "event_type": "CAMPAIGN_CREATIVE_STATUS_UPDATE_REQUESTED",
        "timestamp": "2026-03-03T12:00:00.000Z",
        "summary": "Creative paused by user"
      },
      {
        "event_type": "CAMPAIGN_AD_CREATIVES_ADDED",
        "timestamp": "2026-03-02T15:04:05.000Z",
        "summary": "Creatives added (2)"
      },
      {
        "event_type": "BUDGET_TOPUP",
        "timestamp": "2026-03-01T12:00:00.000Z",
        "summary": "Budget increased"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "totalCount": 3,
      "totalPages": 1
    }
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Authorizations

Authorization

string

header

required

Pass your Soundlink sk_* API key as a Bearer token: Authorization: Bearer sk_<prefix>_<token> (not an OAuth token; see oauthBearer for that). Accepted on all Public API operations. Send only one Authorization header per request.

Path Parameters

campaignId

string

required

Campaign identifier (UUID)

Query Parameters

startDate

string

Return events at or after this moment. YYYY-MM-DD starts at 00:00:00Z. An ISO-8601 timestamp uses that instant.

page

integer

default:1

Page number (1-indexed).

Required range: x >= 1

pageSize

integer

default:20

Items per page (max 100).

Required range: 1 <= x <= 100

Response

Campaign activity page

data

object

required

Show child attributes

meta

object

required

Show child attributes

List campaign activity

curl --request GET \
  --url https://api.getsoundlink.com/v1/campaigns/{campaignId}/activity \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.getsoundlink.com/v1/campaigns/{campaignId}/activity"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.getsoundlink.com/v1/campaigns/{campaignId}/activity', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "items": [
      {
        "event_type": "CAMPAIGN_CREATIVE_STATUS_UPDATE_REQUESTED",
        "timestamp": "2026-03-03T12:00:00.000Z",
        "summary": "Creative paused by user"
      },
      {
        "event_type": "CAMPAIGN_AD_CREATIVES_ADDED",
        "timestamp": "2026-03-02T15:04:05.000Z",
        "summary": "Creatives added (2)"
      },
      {
        "event_type": "BUDGET_TOPUP",
        "timestamp": "2026-03-01T12:00:00.000Z",
        "summary": "Budget increased"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 20,
      "totalCount": 3,
      "totalPages": 1
    }
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

System

Wallet

Campaigns

Soundlinks

Videos

Pixels

List campaign activity

Authorizations

Path Parameters

Query Parameters

Response