campaigns

Sync External Campaigns

Sync external Google, Meta, TikTok, LinkedIn, or ChatGPT campaigns for the active profile.

Campaign identity and daily metrics are fetched at campaign level without filtering native ad types. Provider-specific hydration may add richer media (for example, Google Performance Max asset groups), but an unknown type is still persisted and renderable through the generic document contract. The default bounded mode never infers remote deletion; callers must explicitly request an exhaustive inventory before missing documents are retired.

Providers are independent: a refused one is returned with status="failed" and its reason beside the ones that completed. The request itself fails only when no requested provider could be read.

post/api/campaigns/external/sync

Request

  • Base URL: https://api.usepomo.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.usepomo.ai/api/campaigns/external/sync
  • Auth: HTTP bearer

Request body

platformsstring[]
limitinteger
metrics_lookback_daysinteger
dry_runboolean
exhaustiveboolean

Response

Successful Response

company_profile_idstring uuid required
metrics_lookback_daysinteger required
dry_runboolean required
exhaustiveboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.