Skip to main content
A meta_ads account is an ad account, not a social network. It publishes nothing and receives no messages. What it holds is campaigns — and the ability to promote a Page post you already published.

Campaigns

Campaign → ad set → ad.

Boost

Promote an existing Page post in one call.

Insights

Spend and performance at every level.

Audiences

Meta targeting specs, passed through.

Connect

Same Facebook Login screen as Pages — one authorization can grant both:
Each ad account the user grants becomes its own PlugKit account.
Check what you're spending against
Returns the currency, status and lifetime spend. Read it before your first create — every budget below is expressed in that currency.

Two rules that will bite you otherwise

Budgets are in minor units. 2000 is €20.00, not €2000. Meta expects cents (or the currency’s smallest unit) everywhere: dailyBudget, lifetimeBudget, bidAmount.
Everything is created PAUSED. Campaigns, ad sets and ads all start paused, and boosts too. Set status: "ACTIVE" only after an explicit go on the amount and the audience — that call starts spending real money.

Boost a post

The short path: take a Page post that’s already live and promote it. PlugKit creates the campaign, the ad set and the ad in one call.
postId is the Page post id, in {page-id}_{post-id} form — it’s the platformPostId returned when you published through PlugKit.

The full hierarchy

Campaign
Objectives: OUTCOME_AWARENESS, OUTCOME_TRAFFIC, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_APP_PROMOTION, OUTCOME_SALES.
Ad set — audience, budget, schedule
targeting and promotedObject are Meta specs, passed through unchanged — so anything Meta’s own docs describe works here. Omit targeting and it defaults to France.
Ad — from an existing Page post
Give either objectStoryId (an existing Page post) or creativeId (an existing ad creative). Set the budget either on the campaign (campaign budget optimisation, Meta splits it) or on the ad sets — not both.

Pause, resume, rebudget

PATCH works the same on all three levels:

Insights

Spend and performance, for the whole account or one object:
These are ad metrics — spend, impressions, CPC — and they’re separate from the organic analytics store, which measures posts.

Permissions

ads_management, ads_read, business_management, plus the Page permissions when you boost a Page post.