Meta Ads API for Developers

Zernio's Meta Ads API lets you create and promote posts across Facebook and Instagram via REST. Skip getting Meta Marketing API permissions approved and risking an account ban from connecting external tools. We're an approved partner, so you just POST JSON.

ℹ️

Skip the Meta App Review (and the Ban Risk)

Direct Marketing API access requires creating a Meta App, submitting permissions for App Review (ads_management, ads_read, business_management), and ongoing compliance. Advertisers regularly report accounts being banned for connecting external tools. Zernio is an approved Meta Marketing Partner - you connect, we carry the review.

Key Features

Facebook Ads

Feed, Stories, Reels, Marketplace, and Video ad placements with targeting and creative control.

Instagram Ads

Feed, Stories, Reels, and Explore placements. Boost organic Instagram posts or run standalone campaigns.

Boost Organic Posts

Promote any scheduled or published Facebook/Instagram post as an ad with one API call.

Custom & Lookalike Audiences

Create customer list audiences, website retargeting audiences, and lookalikes programmatically via /v1/ads/audiences.

Real-Time Analytics

Spend, impressions, clicks, CTR, CPC, CPM, and ROAS per campaign and per creative. Breakdowns by age, gender, placement, and country.

Detailed Targeting

Age, gender, location, interests, and behaviors via Meta's targeting taxonomy. Search interest IDs through /v1/ads/interests.

How to use the Meta Ads API with Zernio

  1. 1.
    Enable the Ads Add-On
    Activate Ads in billing. Available on Build, Accelerate, or Unlimited Zernio plans.
  2. 2.
    Connect Facebook + Instagram
    One OAuth flow connects both Facebook and Instagram ad accounts. No Meta App to create.
  3. 3.
    POST to /v1/ads/create
    Launch campaigns, boost posts, build audiences, and query analytics. All via REST.
⏱ Time to first campaign: under 10 minutes

Why Developers Choose Zernio for Meta Ads

No Meta App review

No App Review, no ads_management permissions to justify, no ongoing compliance reviews to fail.

Lower ban risk

Advertisers routinely get flagged for connecting third-party AI tools. Our partner status reduces this risk at the platform level.

Facebook + Instagram together

One connection, both platforms. Schedule organic posts, boost them, or run standalone campaigns across either or both.

Full audience surface

Create customer lists, website audiences, and lookalikes. Upload hashed PII and we handle SHA-256 and audience sync.

Full REST API

Create, pause, edit, delete campaigns. Pull analytics. Manage audiences. Programmatic end-to-end.

Transparent spend tracking

Real-time spend, CPM, CPC, ROAS, and breakdown by age, gender, placement, and country.

Code Examples

Boost an Instagram Post
cURL
curl -X POST "https://zernio.com/api/v1/ads/boost" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postId": "POST_ID",
    "accountId": "ACCOUNT_ID",
    "adAccountId": "act_1234567890",
    "platform": "metaads",
    "name": "Spring launch boost",
    "goal": "traffic",
    "budget": { "amount": 40, "type": "daily" },
    "schedule": {
      "startDate": "2026-04-20",
      "endDate": "2026-04-27"
    },
    "targeting": {
      "age_min": 25,
      "age_max": 45,
      "countries": ["US", "CA", "GB"],
      "interests": [{ "id": "6003139266461", "name": "DevOps" }]
    }
  }'
Create a Lookalike Audience
cURL
curl -X POST "https://zernio.com/api/v1/ads/audiences" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "metaads",
    "adAccountId": "act_1234567890",
    "type": "lookalike",
    "name": "LAL 1% of US customers",
    "lookalikeSource": {
      "originAudienceId": "6123456789",
      "country": "US",
      "ratio": 0.01
    }
  }'

See it in action

Meta Ads dashboard

Manage Facebook + Instagram campaigns, ad sets, and creatives in one table.

Meta Ads analytics

Spend, ROAS, and CPM in real time without opening Meta Ads Manager.

Access Meta Ads API with Zernio

FeatureStatus
Standalone campaigns (FB + IG)Yes
Boost organic postsYes
Custom Audiences (customer list, website, lookalike)Yes
Detailed targeting (interests, age, gender, location)Yes
Campaign › Ad Set › Ad hierarchyYes
Real-time analytics (spend, CPC, CPM, ROAS)Yes
Conversions API (offline events, hashed PII, dedup)Yes
Ad Library APIRoadmap
Advantage+ campaignsRoadmap

If a specific campaign type is blocking your integration, let us know.

Frequently Asked Questions

What is the Meta Ads API?
The Meta Ads API (officially the Meta Marketing API) is Meta's programmatic interface for creating, managing, and reporting on ads across Facebook, Instagram, Messenger, and Audience Network. Zernio wraps it in a REST API with sane defaults.
How much does the Meta Ads API cost?
Meta's API itself is free - you only pay for ad spend. The real cost is engineering: building OAuth flows, managing token refresh, handling rate limits, and staying current with quarterly API deprecations. Zernio's Ads add-on starts at $10/mo on the Build plan.
Do I need Meta App Review?
No. Direct API access requires creating a Meta App, submitting ads_management, ads_read, and business_management permissions for review. Zernio is an approved Meta Marketing Partner - we handle all of it.
Will my ad account get banned?
Meta regularly flags accounts that connect to unvetted third-party tools. Our Marketing Partner status and compliant authorization flow reduce this risk dramatically compared to building your own app or using unverified integrations.
Can I boost Instagram posts?
Yes. POST to /v1/ads/boost with the Zernio postId and platform: 'metaads'. Works for feed posts, Reels, and Stories from a connected Instagram Business account.
Can I create custom audiences with PII?
Yes. Upload customer lists (email, phone, name) via /v1/ads/audiences/{id}/users - we handle SHA-256 hashing per Meta's requirements so you don't send plain PII. Lookalike audiences and website custom audiences are also supported.
Can I run Meta Ads alongside Google or LinkedIn?
Yes. One unified /v1/ads endpoint - the platform parameter picks metaads, googleads, linkedinads, tiktokads, pinterestads, or xads. Same JSON structure regardless of platform.
Can AI agents manage Meta Ads through Zernio?
Yes. Zernio's MCP server includes Meta Ads actions - create campaigns, adjust budgets, pause ads, pull analytics, all accessible from Claude Desktop, Cursor, or any MCP-compatible client.

Related Features

Start Running Meta Ads Without the Approval Wait

Requires the Ads add-on. REST API for Facebook, Instagram, Custom Audiences, and analytics.

SOC 2 CompliantGDPR Compliant