Get tracked-campaign subscription
curl --request GET \
--url https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/subscription \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/subscription"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/subscription', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Task Reference
Get tracked-campaign subscription
Inspect metadata mirror freshness and the fixed history boundary
GET
/
api
/
v2
/
buyer
/
storefront-connections
/
{connectionId}
/
accounts
/
{accountId}
/
directed-campaigns
/
subscription
Get tracked-campaign subscription
curl --request GET \
--url https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/subscription \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/subscription"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/directed-campaigns/subscription', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Returns the durable account subscription created by
Use
subscribe_directed_campaigns.
Named operation: get_directed_campaign_subscription
| Field | Location | Type | Required | Description |
|---|---|---|---|---|
connectionId | path | integer | Yes | Adapter connection ID |
accountId | path | integer | Yes | Connected ad-account row ID |
lastSyncedAt, lastSyncStatus, and lastSyncError to show mirror
health. When the latest sweep failed, errorCode, errorField, errorReason,
and upstreamCode provide the available safe machine-readable diagnosis. A
successful later sweep clears all four diagnostic fields to null.
backfillStart is the fixed one-year metadata boundary set when the account
was subscribed. It does not indicate that delivery reports were imported, nor
is it a running progress indicator: delivery remains live read-through.
lastPresenceSyncedAt, lastPresenceSyncStatus, and lastPresenceSyncError
are the cursor of the separate tracked-presence sweep, which discovers
audiences and event sources (pixels) on the subscribed account. All three are
null until that sweep first visits the subscription. SKIPPED means the
sweep visited but presence discovery did not apply — for example, the
connection does not use a registered adapter provider. A SUCCESS with an empty
presence list
means the account genuinely has no discoverable audiences or event sources.
Response
{
"id": "17",
"customerId": 100,
"advertiserId": "12345",
"connectionId": "42",
"accountId": "81",
"sourceId": "tiktok",
"providerType": "tiktok",
"status": "ACTIVE",
"backfillStart": "2025-07-12T10:00:00.000Z",
"lastSyncedAt": "2026-07-12T10:15:03.000Z",
"lastSyncStatus": "SUCCESS",
"lastSyncError": null,
"errorCode": null,
"errorField": null,
"errorReason": null,
"upstreamCode": null,
"lastPresenceSyncedAt": "2026-07-12T10:20:41.000Z",
"lastPresenceSyncStatus": "SUCCESS",
"lastPresenceSyncError": null,
"createdAt": "2026-07-12T10:00:00.000Z",
"updatedAt": "2026-07-12T10:15:03.000Z",
"archivedAt": null
}
status is the subscription lifecycle (ACTIVE, PAUSED, or ERROR).
lastSyncStatus is the outcome of the latest metadata reconciliation. If it is
ERROR, lastSyncedAt is the time of that failed attempt; show it together with
lastSyncError and any non-null machine-readable diagnostic fields. The
previous valid mirrors are retained. A NOT_FOUND response means this
connection/account has never been subscribed or is outside the authenticated
customer and advertiser scope.
See Campaigns on connected provider accounts.