Get directed campaign subscription (alpha)

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));

GET

api

buyer

storefront-connections

{connectionId}

accounts

{accountId}

directed-campaigns

subscription

Get directed campaign subscription (alpha)

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));

Alpha. This read remains available when the directed-campaigns exposure flag is off so an operator can diagnose or remove an existing subscription.

Returns the durable account subscription created by 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

Use 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 in the connected-account alpha. 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 feature is not enabled for this customer. 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 Directed campaigns (alpha).

⌘I

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Get directed campaign subscription (alpha)

Response

​Response

Response