PluggzyDocs

Meta Ads

InsightsBoostsTargetingLead forms
InsightsBoostsTargetingLead forms

Your Facebook and Instagram ads in any AI app: read spend and results, create campaigns, boost a Facebook or Instagram post, change budgets, bids and targeting, build audiences and read your Instant Form leads. Anything that can spend waits for your yes.

Connect Meta Ads
Connect with
Facebook Login for Business
Structure
Campaign › Ad set › Ad
Tools
3
Nonelimits of Pluggzy’s own: no daily cap, no spacing
Exactwait when the network says slow down, to the second
90 daysof figures brought in at connect
Your yesbefore anything that spends or gives access

What works

What your AI app can do on a Meta Ads account, from the network’s own API.

CreateCampaigns, ad sets and ads, each with a goal.engagementtrafficawarenessvideo_viewslead_generationlead_conversionconversionsapp_promotioncatalog_salespage_likespage_visits
Boost a postA Facebook or Instagram post. With a business login, pass its platformPostId.
BudgetsDaily or lifetime, on the campaign (budgetLevel: campaign) or the ad set (adset). Each ad account has its own minimum daily budget.
BiddingLowest cost with or without a bid cap, cost cap, or a minimum ROAS. Auction or Reach & Frequency.LOWEST_COST_WITHOUT_CAPLOWEST_COST_WITH_BID_CAPCOST_CAPLOWEST_COST_WITH_MIN_ROAS
TargetingCountries, regions, cities, zip codes, custom locations, interests, behaviors, work, income, languages, placements, Advantage audience, saved targeting or a raw spec. With targeting search and reach estimates.
After launchStatus, budget, bid, targeting, a creative swap and the name.
Dry runvalidateOnly checks a single standalone ad without creating it.
AudiencesCustomer lists (email and phone), website, lookalike and engagement audiences, saved targeting.
ConversionsThe Conversions API, with Event Match Quality.
Lead formsInstant Forms and the leads they collect.
Meta onlyClick-to-WhatsApp, Messenger and Instagram Direct ads, call ads, the creative, image and video libraries, previews, product catalogs, Reach & Frequency, value rule sets and ad comments.

Limits

Pluggzy adds no limits of its own to a Meta Ads ad account: no daily cap, no per-minute cap, no spacing. A change goes out as soon as your AI app asks. Only the network’s own rate limits apply.

ActionPluggzy’s own limitTools
Readsspend, results, insights, leadsNonethe network’s own rate limits applyads_read
Spending changesnew ads, boosts, budgets, bids, resumingNonethe network’s own rate limits applyads_write
Other changespausing, audiences, creatives, keywords, conversionsNonethe network’s own rate limits applyads_write
Deletionscampaigns, ad sets, ads, audiencesNonethe network’s own rate limits applyads_write
ReadsNone
spend, results, insights, leads
the network’s own rate limits apply
ads_read
Spending changesNone
new ads, boosts, budgets, bids, resuming
the network’s own rate limits apply
ads_write
Other changesNone
pausing, audiences, creatives, keywords, conversions
the network’s own rate limits apply
ads_write
DeletionsNone
campaigns, ad sets, ads, audiences
the network’s own rate limits apply
ads_write
  • When a network says slow down, Pluggzy waits exactly the time it asks, to the second, and answers rate_limited with retry_after_seconds. Your AI app calls again after it. Nothing is queued behind your back.
  • One Meta Ads sign-in that reaches several ad accounts counts once on your plan.
  • Spend, budgets and results come in the ad account’s own currency.
  • Pausing never waits for a yes.

Connect Meta Ads

Meta’s own sign-in, Facebook Login for Business, from your Pluggzy dashboard.

  1. 1In your Pluggzy dashboard, choose Connect an account and pick Meta Ads.
  2. 2Choose Continue with Facebook and allow access to your ads with Facebook Login for Business.
  3. 3Your ad account shows up in Pluggzy. The last 90 days of figures come in first; older history fills in afterwards.
  4. 4Ask your AI app: “How did my Meta ads do this week?”

Tools

Exactly what your AI app receives from tools/list. The same three tools work on every ad network.

3 tools · 2 read · 1 write
Ads3
The same tools on every ad networkads_operations, ads_read and ads_write work the same on all nine networks; an operation that isn’t on Meta Ads is refused with unsupported.
Ads tools
Generated from pluggzy.com/api/docs · 42 toolsSomething unclear? Write to support · Status