Ads
Create and manage ads in your customers' Meta Ads, Google Ads and TikTok Ads through one API
Everything is created paused, every write is idempotent and a failure midway undoes what was already created. Your product runs your customer's ad account without going through Meta's app review.
POST /api/ads/campaigns?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"name": "Black Friday",
"budget": {
"amount": 50,
"type": "daily"
},
"facebook_ads": {
"objective": "traffic",
"special_ad_categories": []
}
}What you can do
Create a campaign on Meta Ads, Google Ads and TikTok AdsCreate Meta Ads campaigns, Google Ads Demand Gen and Performance Max campaigns or TikTok Ads Traffic, Reach and Video views campaigns with one POST. Starts paused, idempotent.
Create an ad set or ad group on Meta, Google and TikTok AdsCreate Meta Ads ad sets and ad groups on Google Ads (Demand Gen) and TikTok Ads (Traffic, Reach and Video views) by API. Starts paused and idempotent.
Create an ad on Meta Ads, Google Ads and TikTok AdsCreate the ad and the tree above it (campaign and ad set) on Meta Ads, Google Ads or TikTok Ads with one POST. Everything starts paused.
Boost an Instagram post via APIBoost your client's Instagram post with one POST: Connect creates the campaign, ad set and ad from the post. Created paused, idempotent.
Validate a Meta Ads, Google Ads or TikTok Ads ad without creating itValidate the campaign, ad set and ad tree on Meta Ads, Google Ads or TikTok Ads with the same body as POST /ads, without creating anything.
Duplicate a Meta Ads ad, ad set or campaignDuplicate Meta Ads ads, ad sets or campaigns with one POST, changing name, budget or schedule. The copy is created paused by default.
Pause and activate campaigns, ad sets and adsPause or activate your client's Meta Ads campaigns, ad sets and ads with a status PATCH. Works for objects created outside Connect too.
Edit a Meta Ads campaign or ad set budgetChange the budget of a Meta Ads campaign (CBO) or ad set (ABO) via API, in the account's currency, with one PATCH.
Delete Meta Ads campaigns, ad sets and adsDelete a Meta Ads campaign, ad set or ad with one DELETE. A campaign takes its ad sets and ads with it. No Meta app review needed.
List Meta Ads campaigns, ad sets and adsList a customer's Meta Ads campaigns, ad sets and ads with status and budget, live from the account or from what Connect already stores.
See all your customers' Meta Ads in one callList Meta Ads campaigns, ad sets and ads across all your customers in one call, with just the merchant token and filters by customer.
Upload images and videos to Meta Ads, Google Ads and TikTok AdsSend images and videos by URL to the customer's Meta Ads, Google Ads or TikTok Ads account and get back what ads use to reference them.
Search interests, places and languages on Meta Ads and Google AdsTurn a term like "running" into the Meta Ads interest, place or behavior ids, or the Google Ads place and language ids, that targeting expects.
List Meta Ads custom audiences and Google Ads user listsList the customer's Meta Ads custom audiences or Google Ads user lists, with id and approximate size, through the same route.
List Meta Ads pixels and conversion eventsList the pixels in a customer's Meta Ads account and the events each one recorded in the last 90 days, to optimize for conversions.
Create Meta Ads custom conversionsCreate and list Meta Ads custom conversions by URL or pixel event rule, and use the id to optimize an ad set.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
