Ads
The runtime capability snapshot at GET /v1/ads/platforms is authoritative for core Meta, Google, LinkedIn, Pinterest, TikTok, and X operations; GET /v1/ads/accounts/{ad_account_id}/advanced-capabilities is authoritative for the advanced surface. All six networks have registered adapters and dedicated connection authority, but each exposes a different set of typed writes, reads, analytics, targeting, and audience operations. Durable report jobs are implemented only for TikTok and X, plus approval-gated LinkedIn reporting. Lead inbox ingestion, conversion delivery, forecasts, and keyword planning remain unsupported; lead-form and asset/catalog/messaging routes are capability-gated local projections of existing provider resources. See the Advertising Platforms guide. Unsupported and provider-approval-gated operations are rejected before provider I/O. Dedicated connection credential fields are write-only, validated with provider account discovery before persistence, and never returned.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | Upload hashed users to audience | Upload hashed users to audience |
POST | Boost an existing published post | Boost an existing published post |
DELETE | Cancel an ad | Cancel an ad |
POST | Create standalone ad with custom creative | Create standalone ad with custom creative |
POST | Create custom audience | Create custom audience |
POST | Create a campaign | Create a campaign |
POST | Validate and store a dedicated advertising credential | Validate and store a dedicated advertising credential |
POST | Create Ad Conversion Event | Create Ad Conversion Event |
POST | Create Ad Conversion Rule | Create Ad Conversion Rule |
POST | Create Ad Report | Create Ad Report |
DELETE | Delete audience | Delete audience |
DELETE | Cancel/archive campaign | Cancel/archive campaign |
POST | Discover provider ad accounts through a dedicated ad connection | Discover provider ad accounts through a dedicated ad connection |
POST | Forecast Ad Delivery | Forecast Ad Delivery |
POST | Generate Ad Keyword Ideas | Generate Ad Keyword Ideas |
GET | Get ad details | Get ad details |
GET | Get ad analytics with daily breakdown | Get ad analytics with daily breakdown |
GET | Get audience details | Get audience details |
GET | Get campaign details | Get campaign details |
GET | Get Ad Lead | Get Ad Lead |
GET | Get Ad Report | Get Ad Report |
GET | Get Advanced Ad Account Capabilities | Get Advanced Ad Account Capabilities |
POST | Link Ad Catalog | Link Ad Catalog |
POST | Link Ad Creative Asset | Link Ad Creative Asset |
POST | Link Ad Lead Form | Link Ad Lead Form |
POST | Link Ad Messaging Experience | Link Ad Messaging Experience |
POST | Link Ad Product Set | Link Ad Product Set |
GET | List dedicated provider ad accounts | List dedicated provider ad accounts |
GET | List custom audiences | List custom audiences |
GET | List campaigns with aggregate metrics | List campaigns with aggregate metrics |
GET | List dedicated advertising connections | List dedicated advertising connections |
GET | List Ad Lead Forms | List Ad Lead Forms |
GET | List Ad Leads | List Ad Leads |
GET | List truthful ad platform capabilities | List truthful ad platform capabilities |
GET | List Ad Report Results | List Ad Report Results |
GET | List ads | List ads |
POST | Promote Ad Lead | Promote Ad Lead |
DELETE | Revoke and shred an advertising credential | Revoke and shred an advertising credential |
PUT | Validate and rotate an advertising credential | Validate and rotate an advertising credential |
GET | Search targeting interests | Search targeting interests |
POST | Trigger manual sync for an ad account | Trigger manual sync for an ad account |
PATCH | Update ad (name, budget, targeting, pause/resume) | Update ad (name, budget, targeting, pause/resume) |
PATCH | Update campaign (pause/resume) | Update campaign (pause/resume) |
Found something wrong? Help us improve this page.