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. 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 Phase 1.

Response

{
  "id": "17",
  "customerId": 100,
  "advertiserId": "12345",
  "connectionId": "42",
  "accountId": "81",
  "sourceId": "tiktok",
  "providerType": "tiktok",
  "status": "ACTIVE",
  "backfillStart": "2025-07-12T10:00:00.000Z",
  "maxMediaBuyBudget": 100000,
  "maxAccountBudget": 500000,
  "governanceCurrency": "USD",
  "lastSyncedAt": "2026-07-12T10:15:03.000Z",
  "lastSyncStatus": "SUCCESS",
  "lastSyncError": 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. 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).

Get directed campaign delivery (alpha)List directed campaign products (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