Meta Ads
Create and boost Facebook + Instagram ads via Zernio API
Included with the Usage plan. No Meta App review needed. Zernio is an approved Meta Marketing Partner, so you skip the App Review + ads_management permissions entirely.
accountId accepts either shape. You can pass the posting account ID (facebook / instagram) or the ads credential account ID (metaads), Zernio resolves the sibling internally. For Instagram ads, Zernio auto-resolves the linked Facebook Page and the Instagram Business Account ID (no extra field needed). If the Instagram account has no linked Facebook account, the API returns code: "linked_account_required" so you can surface a reconnect flow.
What's Supported
| Feature | Status |
|---|---|
| Standalone campaigns (FB + IG) | Yes |
| Multi-creative campaigns (1 campaign → N ads) | Yes |
| Attach creative to existing ad set | Yes |
| Video creatives (all 3 shapes) | Yes |
| Placement asset customization (different image or video per placement) (details) | Yes |
| Boost organic posts | Yes |
| CBO vs ABO budget routing + updates | Yes |
| Campaign duplication (deep copy) | Yes |
| Campaign deletion (cascades to ad sets + ads) | Yes |
| Bulk pause / resume campaigns | Yes |
| Ad-set-scoped pause / resume | Yes |
| Custom Audiences (customer list, website, lookalike) | Yes |
| Detailed targeting (interests, age, gender, location) | Yes |
| Campaign > Ad Set > Ad hierarchy | Yes |
| Real-time analytics (spend, CPC, CPM) | Yes |
| ROAS + action_values (revenue per action_type) | Yes |
| Pixel management — create, install code, rename, share, stats (details) | Yes |
| Conversions API (offline events, hashed PII, dedup) | Yes |
| Event Match Quality read-back (details) | Yes |
| Ad URL tracking tags — read + update (details) | Yes |
| Click-to-WhatsApp ads (CTWA) | Yes |
| Ad comments (read + moderate dark posts) | Yes |
| Lead Gen Forms (create forms, attach to standalone + boosted ads, leads via webhook) (details) | Yes |
| Ad Library API | Roadmap |
| Advantage+ campaigns | Roadmap |
The campaign tree
Every Meta ad lives in a three-level tree, and each level owns different settings — that split is what decides which endpoint you call:
| Level | Owns | Write endpoints |
|---|---|---|
| Campaign | Objective (goal), bid strategy, the budget on CBO campaigns | Update, pause/resume (cascades down), duplicate, delete (cascades down) |
| Ad set | Targeting, schedule, the budget on ABO campaigns, promotedObject | Update, pause/resume |
| Ad | The creative: headline, body, media, CTA, link | POST /v1/ads/create with adSetId adds an ad to an existing ad set |
You rarely build the tree level by level: POST /v1/ads/create creates all three in one call, POST /v1/ads/boost wraps an existing organic post the same way, and GET /v1/ads/tree reads the whole hierarchy back, nested with rolled-up metrics. Whether the budget lives on the campaign (CBO) or the ad set (ABO) decides which update endpoint accepts it — see budget routing.
OAuth Scopes
Meta ads run on the token of a connected Facebook account. Workspaces with the Ads add-on request these additional scopes during the standard Facebook connect flow:
| Scope | What it enables |
|---|---|
ads_management | Create and manage campaigns, ad sets, ads, creatives and pixels |
ads_read | Read ad accounts and insights |
pages_manage_ads | Create, list and archive lead forms on the Page |
leads_retrieval | Read submitted leads from lead ads |
Instagram Login can't grant ads scopes, so ads owned by Instagram accounts are managed with the token of a Facebook account connected in the same profile.
Accounts connected before the Ads add-on was enabled won't have these scopes; reconnect the account to pick them up. Account Health shows what a connected account was actually granted.
In This Section
Ad Comments
Read and manage comments on your Meta ads
Boost a Post
Turn an existing organic post into a paid ad
Campaigns & Ad Sets
Create standalone campaigns and manage campaigns, ad sets, and budgets
Creative Testing
Run multi-creative campaigns to test variations
Conversion Campaigns
Conversion campaigns and promoted objects
Creatives
Attach creatives, video creatives, and placement asset customization
Custom Audiences
Build custom and lookalike audiences
Targeting
Interest, demographic, and behavior targeting
Lead Gen Forms
Create and manage Meta lead generation forms
Click-to-WhatsApp Ads
Create ads that open a WhatsApp conversation
Meta Pixels
Create and manage Meta Pixels
Conversions API
Send server-side conversion events to Meta
Ad URL Tracking Tags
Attach click-URL tracking parameters to ads
Media Requirements
Image and video requirements for Meta ads