How to Master Creative Planning Asset Management? (2025)
Stop wasting time searching for creative files. This guide shows you how to organize assets, speed up campaigns by 60%, and test more ad variations.
TABLE OF CONTENTS
Meta Ads API: Complete Guide for Advertisers and Developers (2025)
Complete 2025 guide to the Meta Ads API. Learn how to automate Facebook and Instagram ads at scale, from setup to launching 1,000+ ads programmatically.
If you're searching for "Meta Ads API," you're probably looking to unlock serious automation power for your Facebook and Instagram advertising. Maybe you're a developer building an integration, a marketer drowning in manual ad launches, or an agency looking to scale campaigns across dozens of client accounts without losing your mind.
The Meta Ads API (officially called the Facebook Marketing API) is how you programmatically create, manage, and report on ads without touching the Ads Manager interface. It's the difference between launching 50 ads manually over a week and launching 1,000 ads in an afternoon. This guide will walk you through everything you need to know about the Meta Ads API in 2025, from getting access to advanced automation strategies.
What Is the Meta Ads API?
The Meta Ads API is a set of programmatic endpoints that let you talk directly to Meta's advertising platform through code. According to Facebook's official documentation, it allows you to "create and manage your ads programmatically and retrieve data about your ads to build custom reports and analyze performance."
Here's the simple version: anything you can do in Facebook Ads Manager, you can do through the API (and often more efficiently).
The API is built on Meta's broader Graph API structure, which organizes everything into three concepts:
→ Nodes: Individual objects with unique IDs (an Ad Account, a Campaign, an Ad Set, an Ad)
→ Edges: Connections between objects (a Campaign has an edge called "/adsets" that lists all its ad sets)
→ Fields: Properties you can read or change (a campaign's name, status, objective, budget)
When you make an API call, you're essentially saying: "Give me this node, show me this edge, and include these fields." That's the framework for every operation you'll do.
Quick clarification on related APIs: The Meta Ads API is different from the Conversions API (which sends conversion events from your server to bypass browser blockers) and the Ads Library API (which provides public transparency data about ads). We're focusing specifically on the Marketing API for campaign management and reporting.
Why Use the Meta Ads API?
The API isn't just a technical curiosity for developers. It solves real operational problems that every performance marketer faces at scale.
The Throughput Problem
Manual ad launching hits a wall fast. If you're testing creative variations at any meaningful volume, you know the pain: copying campaigns, adjusting targeting, uploading creatives, setting budgets, checking naming conventions, adding UTM parameters. It's tedious work that eats hours.
Ad operations automation platforms demonstrate that automated systems can launch approximately 494,000 ads in a 30-day period, saving an estimated 37,087 hours of manual work. That throughput simply isn't possible with human clicking.
What the API Actually Unlocks
Bulk operations at scale
You can generate hundreds or thousands of ads from templates, each with unique creative combinations, targeting parameters, and naming conventions. Launch them all as paused, get approval, then activate them simultaneously. This is how top-performing brands test creative variations aggressively without drowning their media buyers.
Custom reporting and analytics
The Insights endpoints give you access to over 70 performance metrics with complete control over date ranges, breakdowns, and attribution windows. You can pull exactly the data you need, in exactly the format you need, and feed it directly into your BI tools or custom dashboards.
Workflow automation
Build tools that fit your process, not Meta's UI. Automatically create campaigns from your product catalog, adjust budgets based on external data, pause underperforming ads at specific thresholds, or pull daily reports that combine Facebook performance with data from other channels.
Social proof preservation
Through the API, you can easily create ads that use existing Page posts by referencing their post IDs. This preserves social proof by maintaining all the likes, comments, and engagement on a single post across multiple ad variations. It's a common tactic that's straightforward via API but clunky in the UI.
Consistency and quality control
When you codify your campaign creation process, you eliminate human errors. No more typos in ad copy, inconsistent naming conventions, missing UTM parameters, or accidentally targeting the wrong country. Your automation enforces your standards every single time.
Who Actually Benefits from This?
Honestly? Anyone managing more than 20-30 ads per week should be thinking about API-based tools.
→ Data analysts who need granular reporting beyond what Ads Manager provides
→ Developers integrating Facebook ads into larger marketing automation systems
You don't necessarily need to code directly against the API yourself (more on that later), but understanding how it works helps you evaluate tools and make better decisions about your ad operations stack.
How to Get Access to the Meta Ads API
Getting Meta Ads API access involves navigating Meta's developer ecosystem, which can feel bureaucratic if you've never done it. Here's the step-by-step path.
1. Create a Meta Developer Account
Head to Meta for Developers and sign up using your Facebook credentials. Your developer account is essentially an admin console tied to your personal Facebook, but it's where you'll manage API access for any apps you create.
2. Set Up a Developer App
In the Meta Developer Dashboard, create a new app. When setting up the app:
- Choose the Business use case
- Enable the Marketing API product during setup
- You'll receive a unique App ID
Think of the app as the entity that will authenticate and make API calls on your behalf. Add valid business details since you'll need them for the verification steps ahead.
3. Verify You Have an Active Ad Account
The API operates on Facebook Ad Accounts, so you need at least one active account to work with. It should:
- Be connected to a Business Manager (now part of Meta Business Suite)
- Have a valid payment method
- Be in good standing with no policy violations
If you're managing ads for clients or multiple brands, organize everything through Business Manager. That's where you'll control permissions and handle the verification requirements.
4. Configure API Permissions
Meta uses an OAuth permission system. Your app needs specific scopes approved to use the Ads API. The two essential permissions are:
ads_management: Create, manage, or delete ad campaigns (write access)
ads_read: Read ad performance data and campaign info (read access)
You might also need:
- business_management: Manage ad accounts or audiences on behalf of a Business
- pages_manage_ads: Manage ads for Facebook Pages
- pages_read_engagement: Read comments on ads
In development mode, these permissions work for ad accounts where you're an admin. To use the API in production (for other clients or accounts), you need Advanced Access, which requires app review and policy compliance.
According to Meta's permission documentation, "permissions define what your app can do, and Standard Access limits you to your own assets while Advanced Access opens up production use cases."
5. Complete Business Verification (Required for Advanced Access)
Meta requires Business Verification for apps that will handle sensitive operations or access others' data at scale. You'll submit:
- Legal business name and registration details
- Business address and phone number
- Business website
- Proof of identity for the app administrator
Business Verification is mandatory if you need Advanced Access to ads_management or if you want to create ad accounts programmatically. The process usually takes a few business days.
6. Generate an Access Token
Once your app is configured with the right permissions, you need an access token to authenticate API calls. An access token is essentially your API key, containing your app credentials and the user's granted permissions.
For testing: Use the Graph API Explorer tool. Select your app, add the required scopes (like ads_management), and generate a user token. These tokens typically expire after about 1-2 hours.
For production: You have a few options:
Token Type | Lifespan | Best For |
Short-term User Token | ~1 hour | Quick testing and development |
Long-term User Token | Up to 60 days | Ongoing scripts (with manual renewal) |
System User Token | Renewable programmatically | Server-to-server integrations (ideal) |
For ongoing automation, System User tokens are the gold standard. You create a System User in Business Manager, and the token doesn't depend on a specific person staying logged in. These tokens can be extended programmatically and never expire as long as you maintain them.
Security note: Treat access tokens like passwords. They grant full access to your ad accounts. Never commit them to code repositories, expose them in client-side code, or share them publicly. Store them encrypted if possible, and set up token refresh logic to handle expiration.
7. Test Your Setup
With a token in hand, make a test API call. A simple one to start:
GET /me/adaccountsThis endpoint lists all ad account IDs accessible to your token. If it returns your accounts, your setup works. Try another test:
GET /act_{AD_ACCOUNT_ID}/campaigns to list campaigns in a specific account.If these calls succeed, you're ready to start building. If you get errors, they're almost always permission-related. Check that:
- Your token user has admin access to the ad account
- Your app has the required permissions enabled
- Your app is in live mode (if testing outside development)
- The token hasn't expired
Pro tip: Meta's documentation recommends understanding the ad object hierarchy before diving in: Ad Account > Campaign > Ad Set > Ad. Every ad object lives under an ad account, and relationships flow parent to child.
How to Create and Manage Ads via API
Once you have access, using the Meta Ads API involves calling various endpoints to create, update, or fetch ad objects. Let's break down the core components.
Campaigns: The Top-Level Container
A campaign defines your marketing objective (conversions, traffic, app installs, brand awareness, etc.) and optionally a campaign-level budget. When creating a campaign, you specify:
- Campaign name
- Objective (like "CONVERSIONS" or "LINK_CLICKS")
- Buying type (usually "AUCTION")
- Status (ACTIVE or PAUSED)
- Whether to use Campaign Budget Optimization (CBO)
Example API call:
POST https://graph.facebook.com/v18.0/act_{AD_ACCOUNT_ID}/campaigns Parameters: name, objective, status, buying_type
You'll receive a campaign ID if successful. Most people create campaigns as PAUSED initially to review before they start spending.
Ad Sets: Targeting, Placement, and Budget
An ad set lives within a campaign and defines the who, where, when, and how much of your advertising. Each campaign can have multiple ad sets to test different audiences or budget strategies under the same objective.
When creating an ad set, you provide:
→ The parent campaign ID
→ Daily or lifetime budget (if not using CBO)
→ Schedule (start and end time)
→ Targeting specifications (location, demographics, interests, custom audiences)
→ Placement choices (or use automatic placements)
→ Optimization goal and bid strategy
→ The Facebook Page or Instagram account that will run the ads
This is a complex call because of the many options. At minimum, you need a campaign reference, a budget, targeting info, and optimization settings. The API call looks like:
POST /act_{AD_ACCOUNT_ID}/adsets Body: JSON with campaign_id, name, daily_budget, billing_event, optimization_goal, targeting, etc.
Ads and Ad Creatives: What Gets Delivered
An ad is the actual creative unit that users see. It lives inside an ad set. Creating an ad typically involves two steps:
Step 1: Create an Ad Creative
The creative defines the ad content: image or video, ad copy text, headline, call-to-action button, link URL, etc.
You can either:
- Create a brand new creative from scratch
- Reference an existing Facebook Page post (using its post ID)
Using an existing post preserves social proof (likes and comments accumulate on one post across multiple ads). This is a common tactic and straightforward via API.
POST /act_{AD_ACCOUNT_ID}/adcreatives Body: page_id, instagram_actor_id, message, link_data or object_story_spec
Step 2: Create the Ad
Once you have a creative ID, you create the ad:
POST /act_{AD_ACCOUNT_ID}/ads Body: adset_id, name, creative (the creative ID), status
You'll receive an ad ID. The ad is now created but subject to Facebook's review process before it can run.
Assets: Images and Videos
If you're creating new creatives (not using existing posts), you'll need to upload assets first. The API provides endpoints for this:
POST /act_{AD_ACCOUNT_ID}/adimagesfor images
POST /act_{AD_ACCOUNT_ID}/advideosfor videos
These return an image_hash or video_id that you reference in your creative. Alternatively, you can use Meta's Asset Library if you manage assets through Business Manager.
Platform-specific note: Tools like AdManage handle the asset uploading and give you a UI for selecting images, but when building directly against the API, remember to upload files before creating creatives that reference them.
Status Management and Moderation
All ads created via API go through the same Facebook ad review process as manually created ads. You can:
- Set initial status to PAUSED to prevent immediate spending after approval
- Read the approval status field to check if an ad is approved, rejected, or pending review
- Resubmit rejected ads by editing them and setting status to ACTIVE again
The API lets you check ad status programmatically, which is useful for building workflows that wait for approval before proceeding.
Editing and Deleting
You can update or delete objects through the API:
POST /{Ad_ID}with updated fields to edit an ad
DELETE /{Ad_ID}to remove an ad
POST /{Adset_ID}to change budget, targeting, or status
Not every field can be changed on the fly (some changes require creating new ads), but budgets, bids, and statuses are commonly adjusted. Keep in mind that some edits can reset the learning phase, just like in the UI.
Rate Limits: Don't Get Throttled
Meta imposes limits on API call volume, calculated on a rolling 1-hour window. According to their documentation, "you can make a limited number of calls per hour," and the limit considers both call frequency and data volume per call.
Heavy operations (like pulling massive insights reports with breakdowns) count more against your limit than simple reads. If you exceed the limit, the API returns error responses telling you to slow down.
For most developers, the default rate limit is sufficient to start. If you need higher throughput, you can apply for higher rate tiers through the "Ads Management Standard Access" feature, which typically requires demonstrating a legitimate business case.
Best practice: Build your integration to handle rate-limit errors gracefully. Use exponential backoff (wait progressively longer between retries) when you hit limits.
Common Permission Errors
In practice, many API errors when starting out are permission-related. You might see:
- (#100) Missing permission
- (#200) Permission denied
This usually means your access token doesn't have the required scope, or the token user isn't an admin of the ad account/app. Double-check that:
- The user associated with your token has admin access to the ad account
- Your app is in live mode with approved permissions (if not testing)
- You've granted the specific OAuth scopes needed
If connecting on behalf of other users or accounts, you'll need to set up proper OAuth login flows so those users can grant your app permission to their accounts.
How to Retrieve Ad Data and Insights
Creating ads is only half the story. The Ads Insights API is where you pull performance data for reporting and optimization. This is how you get metrics like impressions, clicks, spend, conversions, ROAS, and more.
The Insights Endpoint Structure
You can query insights at any level of the ad hierarchy:
GET /{object_id}/insights
Where
object_id can be an Ad ID, Ad Set ID, Campaign ID, or Ad Account ID.Example: To get last 30 days of campaign data:
GET /act_{AD_ACCOUNT_ID}/insights?level=campaign&date_preset=last_30d&fields=campaign_name,impressions,clicks,spend,actions
This returns name, impressions, clicks, spend, and conversion actions for each campaign in the account.
Fields and Metrics (There Are 70+ Available)
By default, an insights query might return only basic fields like impressions and spend. But over 70 metrics are available, including:
Metric Category | Examples |
Delivery Metrics | Reach, frequency, impressions |
Engagement Metrics | Clicks, CTR, link clicks |
Cost Metrics | CPM, CPC, cost per action |
Conversion Metrics | Purchases, leads, ROAS, conversion value |
Video Metrics | Video views, completion rate, watch time |
Relevance Metrics | Quality ranking, engagement rate ranking |
Best practice: Request only the fields you need. Including unnecessary fields increases API load and slows down your queries.
Example fields parameter:
fields=campaign_name,adset_name,ad_name,impressions,clicks,actions,action_values,cost_per_action_type
The
actions field breaks down conversions by type (purchases vs leads vs page views), and action_values gives you conversion values for ROAS calculations.Note on data reliability: Some metrics are marked as "estimated" or "in development" by Meta (like certain relevance scores or attribution metrics). These may be subject to modeling or future changes, so always validate critical metrics against Ads Manager.
Date Ranges and Time Increments
You can specify:
- Preset periods: today, yesterday, last_7d, last_30d, etc.
- Custom ranges: using since and until parameters (YYYY-MM-DD format)
- Time increments: Break results by day, week, or month
Custom date ranges can overlap, which is useful for comparing performance across different time windows.
Example: Daily breakdown for the last 14 days:
?date_preset=last_14d&time_increment=1
Breakdowns: Slicing Data by Dimensions
Breakdowns let you split data by dimensions like age, gender, country, placement, device, etc. Common breakdown options include:
- age
- gender
- country
- placement
- device_platform
- frequency_value
Example: Get ad set results broken down by age and gender:
?breakdowns=age,gender
Warning: Adding breakdowns multiplies the number of rows returned exponentially. An ad set with 5 age buckets and 2 genders returns 10 rows instead of 1. This increases data volume and API load significantly.
Also, Meta now limits historical breakdown data for certain metrics. As of June 10, 2025, reach broken down by age/gender is capped to the past 13 months. Queries beyond that window will fail.
Attribution Windows: How Conversions Get Counted
If you're pulling conversion metrics, attribution windows matter. The API allows specifying
action_attribution_windows to control which conversions are counted.Available values include:
- 1d_click (1-day click attribution)
- 7d_click (7-day click attribution)
- 1d_view (1-day view attribution)
- 28d_click (28-day click attribution)
By default, Meta often uses a 7-day click / 1-day view window. But you can override it:
?action_attribution_windows=["7d_click","1d_view"]
Important 2025 update: In mid-2025, Meta introduced unified attribution settings. The API now "enforces attribution logic automatically," meaning conversion metrics align more closely with Ads Manager by default. Specifically, on-Facebook conversions are counted at impression time, matching how Ads Manager reports them.
This change improves consistency between API and UI reporting, but it also means your conversion metrics might look different compared to pre-June 2025 data. If you need custom attribution windows, you must explicitly specify them in the API call.
Pagination and Asynchronous Jobs
If your query returns a lot of data, Meta paginates results. The API response includes a
paging object with a next URL for fetching additional rows.Tip: Always set up pagination logic in your reporting scripts to ensure you capture all data.
For extremely large jobs (like pulling a year of daily data for hundreds of ads), you can use asynchronous reporting. Set the
async=true parameter, and Meta will process the job in the background. You'll receive a job ID to check status and download results when ready.This approach prevents timeouts and makes heavy reporting tasks more reliable.
Error Handling in Reporting
Sometimes data won't come through as expected:
- Fields might be blank if data is unavailable
- You might get errors for invalid breakdown combinations (not all breakdowns can be combined arbitrarily)
- Queries for too granular data over long periods may timeout
Best practice: Always include error handling in your scripts. Log issues for debugging, and consider splitting large requests into smaller chunks (like month-by-month) if you hit timeouts.
Meta Ads API Version Updates and Deprecations
Facebook updates the API version roughly quarterly, with two major versions each year and occasional out-of-cycle updates. As of late 2025, we're around Marketing API Version 18 or 19.
Critical upcoming deprecation: Meta announced it will deprecate legacy Advantage Shopping and App Campaign APIs by Q1 2026 (Marketing API v25). Everyone will need to migrate to the newer Advantage+ campaign structures.
Staying Current
- Subscribe to Meta for Developers announcements
- Read release notes for each version
- Specify API versions explicitly in your calls (e.g.,
v18.0) to avoid sudden breakage
- Test key operations after major updates
Meta guarantees support for each version for at least 2 years from release, but deprecated features will eventually stop working. Building update checks into your automation prevents nasty surprises.
Best Practices for Using the Meta Ads API
1. Start in a Sandbox
Use a test ad account or minimal budget when first running API scripts. Mistakes in code (like accidentally creating hundreds of campaigns in a loop) can spend real money fast.
Create a campaign with a small budget and pause it immediately to test your create/edit flows safely.
2. Secure Your Tokens and App
① Never embed access tokens in client-side code
② Store tokens encrypted in secure environments
③ Set up proper OAuth flows if building for other users (don't use a single token for all clients)
④ Regularly rotate long-lived tokens
⑤ Configure App Alerts in the developer dashboard to get notified of issues
3. Follow Facebook Ads Policies
The API doesn't bypass advertising policies. All ads created via API must comply with:
- Content guidelines (no prohibited content)
- Proper targeting (no discriminatory practices)
- Personal attributes restrictions in copy
- Accurate business representation
Ensure your automation doesn't inadvertently create policy-violating ads at scale. That could risk your entire ad account.
4. Use SDKs and Libraries
Meta provides official SDKs for Python, PHP, JavaScript, and other languages. These handle authentication, query construction, pagination, and error handling more conveniently than raw HTTP calls.
While understanding the underlying REST endpoints is valuable for troubleshooting, SDKs can significantly reduce boilerplate code and development time.
5. Set Up Logging and Monitoring
When running automated systems:
- Keep logs of all actions (e.g., "Created Campaign X with budget Y at timestamp Z")
- Monitor performance and errors in real-time
- Build safety checks (e.g., don't allow budgets above certain thresholds)
- Set up email/Slack alerts for critical actions or errors
If something goes wrong (like a script setting incorrect bids), you want to catch it immediately.
6. Test After Facebook Changes
Since Meta updates the API often:
- Pin your integration to a specific API version (e.g.,
v18.0) to avoid sudden changes
- Keep an eye on deprecation announcements
- Test key operations (creating campaigns, pulling reports) after major updates
- Build flexibility into your integration to adapt to API changes quickly
7. Try New Features Early
Meta continuously adds features around automation and AI optimization. Examples:
- Advantage+ campaigns
- Automatic placements
- Dynamic creative optimization
- AI-tested placement exploration (where Meta tests even excluded placements)
Staying aware of new features via API lets you experiment early and potentially gain a performance edge before competitors adopt them.
8. Learn from the Community
The official Meta Marketing API documentation is comprehensive and detailed. It's your primary reference.
Also valuable:
- Stack Overflow for troubleshooting specific errors
- Reddit communities like r/facebookmarketing
- Developer Discord servers and Slack groups
- Case studies from companies scaling with the API
Many developers have encountered (and solved) the same issues you'll face. Don't reinvent wheels unnecessarily.
Should You Build Directly with the API or Use Third-Party Tools?
After seeing all the capabilities (and complexity) of the Meta Ads API, you might wonder: Should I build directly with the API or use a third-party tool?
When to Build Directly with the API
Go the custom route if:
- You have very specific needs that off-the-shelf tools can't meet
- You want to deeply integrate Facebook Ads with your own product or internal system
- You're comfortable coding and want maximum flexibility
- Your technical team can maintain and update the integration
- You need complete control over every aspect of campaign management
Building directly gives you maximum power but requires ongoing development and maintenance resources.
When to Use Third-Party Tools
Use existing platforms if:
- Your needs are achievable with current solutions
- You want to move fast without building infrastructure
- Your team prefers UI-based workflows over coding
- You need additional features beyond what the API provides (like creative optimization algorithms, multi-platform support, or template systems)
- The cost of the tool is less than the engineering time to build equivalent functionality
Many third-party tools handle the API complexity for you while adding valuable features on top.
Decision Framework: Build vs. Buy
Factor | Build Direct | Use Tool |
Speed to launch | Weeks to months | Hours to days |
Customization | Complete control | Limited to tool features |
Maintenance | Ongoing dev resources | Vendor handles updates |
Cost structure | Dev time + infrastructure | Monthly subscription |
Complexity | Full API knowledge needed | UI-based workflows |
Best for | Unique workflows, custom integrations | Standard bulk operations, quick scaling |
Examples of Third-Party Solutions
For automated reporting: Services can pull Facebook Ads data into Google Sheets, Excel, or BI tools with no coding required. You configure the metrics you want, set a schedule, and the data flows automatically.
For bulk ad creation and management: Platforms like AdManage offer UI-based workflows for launching hundreds or thousands of ads at scale. They rely on the API under the hood but provide:
- Creative templates and asset management
- Multi-platform support (Meta + TikTok)
- Post ID preservation for social proof
- Bulk preview links for approvals
These tools save you from building and maintaining your own ad operations infrastructure. The trade-off is less customization compared to building directly against the API.
For specialized use cases: Other platforms offer advanced features like automated optimization rules, creative rotation algorithms, or cross-channel campaign management.
The Hybrid Approach (Often Best)
Many sophisticated advertisers use a hybrid model:
- Use third-party tools for day-to-day bulk operations and standard reporting
- Maintain small custom scripts for specialized tasks the tools don't handle
Example: Use AdManage to handle bulk launching of ad variations with enforced naming and UTM standards, but run a custom Python script nightly that pulls specific metrics from the API and sends customized alerts to Slack.
This approach balances speed and efficiency with flexibility for unique needs.
How AdManage Simplifies Meta Ads API Automation
At AdManage, we built our platform specifically to solve the operational bottlenecks that come with scaling Facebook and Instagram advertising. Our entire infrastructure runs on the Meta Ads API, but we've abstracted away the complexity so you can focus on strategy and creative testing instead of API authentication and endpoint management.
What We Built (And Why It Matters)
Bulk launching at production scale
Our platform can launch thousands of ads in a single session. According to our public status page, we've processed approximately 494,000 ads in the last 30 days alone, representing about 37,087 hours saved in manual work.
That throughput is only possible because we've optimized every aspect of the API workflow: parallel request handling, intelligent rate limit management, automated retry logic for transient errors, and efficient asset uploading.
Naming conventions and UTM enforcement
One of the most tedious aspects of manual ad launching is maintaining consistent naming and tracking parameters. Through AdManage, you define your naming schema and UTM rules once at the account level, and we enforce them automatically on every ad launch. No more spreadsheets of naming conventions or QA checks for missing parameters.
Post ID preservation for social proof
We make it trivial to launch ads using existing Facebook Page posts, which preserves engagement (likes and comments) across multiple ad variations. This is straightforward via API but clunky in the UI. With AdManage, you simply select the post you want to use, and we handle the creative ID mapping behind the scenes.
Creative grouping by aspect ratio
When you upload a batch of images or videos, we automatically group them by aspect ratio and create the appropriate creative formats for each placement (1:1 for feed, 9:16 for Stories, 16:9 for in-stream video, etc.). This eliminates the manual work of matching creatives to placements.
Multi-platform support
We support both Meta (Facebook + Instagram) and TikTok through a unified interface. Launch the same creative set to both platforms simultaneously, with platform-specific optimizations handled automatically.
Google Sheets integration
Our Google Sheets Add-on lets you build campaigns directly in spreadsheets and launch them with a click. You can also export campaign data back to Sheets for analysis. It's the best of both worlds: spreadsheet familiarity with API power.
Custom dashboards and reporting
We provide 12 pre-built dashboards that pull data via the Insights API, plus the ability to create custom views with the exact metrics and breakdowns you need. All the data is pulled programmatically and updated in real-time.
How AdManage Fits Into Your Stack
If you're evaluating whether to build directly against the Meta Ads API or use a platform like AdManage, consider this:
Use AdManage if:
- You launch 100+ ad variations per month and manual processes are slowing you down
- You need consistent naming, UTM parameters, and creative standards across teams
- You value having bulk preview links and approval workflows built in
- You want to preserve social proof by reusing Page posts across ads
- You'd rather spend time on strategy and creative testing than building API infrastructure
Build custom if:
- You have extremely unique workflows that no existing tool supports
- You need to integrate Facebook Ads deeply into your own product
- You have engineering resources available to build and maintain the integration
Many of our customers use AdManage for 90% of their ad operations and maintain small custom scripts for the remaining 10% of edge cases. That hybrid approach gives you the best of both worlds.
Pricing and Getting Started
We offer straightforward fixed pricing with no ad spend taxes:
Plan | Price | What's Included |
In-house | £499/month | 3 ad accounts, unlimited uploads, launches, team members, and spend |
Agency | £999/month | Unlimited ad accounts, unlimited uploads, launches, team members, and spend |
Enterprise | Custom pricing | Adds SSO/SAML, custom SLA, white-label reports, audit logs |
All plans include a 30-day risk-free refund period. You can explore our features risk-free and cancel if it's not the right fit.
Ready to automate your ad operations? Check out our pricing and see how AdManage can help you scale your Meta advertising without scaling your headcount.
Remember: The API Is a Tool, Not a Strategy
The Meta Ads API is incredibly powerful, but it's important to keep perspective. The API doesn't magically improve your advertising performance. What it does is remove operational bottlenecks so you can test more creatives, iterate faster, and make data-driven decisions at higher velocity.
Great advertising still requires:
- Compelling creative that resonates with your audience
- Clear value propositions
- Effective targeting
- Smart budget allocation
- Continuous testing and learning
The API (or tools built on it) accelerate your ability to execute on these fundamentals. They give you leverage. But they're not a substitute for strategic thinking and creative excellence.
If your current ads aren't performing well, automating the creation of similar ads won't fix the problem. But if you have found a creative approach that works and you need to test variations at scale, the API unlocks capabilities that manual processes simply can't match.
Use automation to amplify good decisions, not to make bad decisions faster.
Frequently Asked Questions
What's the difference between the Meta Ads API, Conversions API, and Ads Library API?
The Meta Ads API (Marketing API) is for creating, managing, and reporting on ad campaigns programmatically. The Conversions API is a separate tool for sending conversion events from your server to Facebook to improve tracking (it bypasses browser ad-blockers). The Ads Library API provides public transparency data about ads running on Meta's platforms. They're three different tools for different purposes.
Do I need to know how to code to use the Meta Ads API?
Not necessarily. While understanding the API helps you evaluate tools and make better decisions, you can access API-powered functionality through third-party platforms like AdManage without writing any code. These tools provide UI-based workflows built on top of the API.
If you want to build custom integrations, yes, you'll need coding skills (or a developer to help). Languages like Python, PHP, and JavaScript have official Meta SDKs that make development easier.
How much does Meta Ads API access cost?
API access itself is free. You're not charged by Meta for making API calls (within their rate limits). You'll still pay for ad spend like normal. If you use third-party tools that rely on the API, those tools typically charge their own fees.
What are the rate limits for the Meta Ads API?
Meta imposes limits based on a rolling 1-hour window, considering both call frequency and data volume. The exact limits depend on your app's tier (standard vs. advanced access) and usage patterns. Heavy operations (like large insights queries) count more against your limit than simple reads.
For most use cases, the default limits are sufficient. If you need higher throughput, you can apply for elevated access through Meta's Ads Management Standard Access program.
Can I use the API to manage ads for multiple client accounts?
Yes, but you'll need to properly configure permissions through Business Manager. You'll either:
- Add client ad accounts to your Business Manager (if they trust you with full admin access)
- Set up OAuth flows so clients can grant your app specific permissions to their accounts
The second approach is more scalable for agencies since clients maintain control of their assets while granting your app limited permissions.
How do I handle API errors and debugging?
Common API errors include:
- Permission errors (100, 200): Your token lacks required scopes or account access
- Rate limit errors (613, 80004): You're making too many calls too quickly
- Invalid parameter errors (100): You're passing incorrect field names or values
- Object not found errors (803): The ID you're referencing doesn't exist
Best practices:
- Set up robust error logging to capture full error messages
- Build retry logic with exponential backoff for transient errors
- Use the Graph API Explorer tool to test queries interactively
- Check Meta's error code reference documentation
- Monitor your app's health dashboard for alerts
Does the Meta Ads API work with Instagram?
Yes. The Marketing API handles both Facebook and Instagram ads (Meta treats them as a unified advertising platform). When creating campaigns via API, you can specify Instagram placements and associate Instagram accounts with your ad creatives.
Many operations are identical for both platforms, though some creative formats and features are platform-specific.
How often does Facebook update the API?
Roughly quarterly, with two major versions per year and occasional out-of-cycle updates. Each version is supported for at least 2 years from release.
Important: Pin your integration to a specific version (like v18.0) to avoid unexpected breaking changes. Monitor deprecation announcements and plan to upgrade before your version reaches end-of-life.
Can I use the API to automate bidding and optimization?
Yes, but with caveats. You can programmatically adjust budgets, bids, and optimization goals through the API. But Facebook's machine learning systems handle most optimization automatically based on your objective and bid strategy.
The API is better suited for rule-based automation (like pausing ads that exceed a certain CPA threshold) rather than trying to outsmart Meta's own optimization algorithms. Most successful use cases focus on creative testing velocity and operational efficiency rather than bid manipulation.
What's the difference between Standard Access and Advanced Access?
Standard Access lets you use API permissions on your own ad accounts and assets (where you're an admin). It's good for testing and personal use.
Advanced Access is required if you want to:
- Use the API on others' ad accounts (like client accounts)
- Create ad accounts programmatically
- Access certain sensitive data at scale
Advanced Access requires app review and Business Verification. Meta wants to ensure you're a legitimate business before granting broad permissions.
How do I keep my access tokens from expiring?
Short-term tokens (1-2 hours) are only for testing. Long-term user tokens last up to 60 days but require manual renewal.
For production systems, use System User tokens from Business Manager. These can be extended programmatically and won't expire as long as you maintain them. Set up token refresh logic to check expiration and renew tokens before they die.
Security reminder: Never expose tokens in client-side code or commit them to repositories. Store them encrypted in secure environments.
Does using the API bypass Facebook's ad review process?
No. All ads created via API go through the same review process as manually created ads. You'll still need to comply with all advertising policies, and your ads can be rejected just like any others.
The status can be checked programmatically via the API, which lets you build workflows that wait for approval before taking next steps.
Can I get historical data for ads that have been deleted?
Generally no. Once an ad is deleted, its data becomes inaccessible via the API. This is why it's crucial to pull and archive performance data regularly if you need long-term historical records.
Best practice: Build automated reporting that pulls insights daily and stores them in your own database or data warehouse. Don't rely on the API as your only historical record.
What happens if I exceed API rate limits?
The API will return error responses (typically error code 613 or 80004) telling you to slow down. Your calls will be rejected until you're back under the limit.
Best practices:
- Use exponential backoff (wait progressively longer between retries)
- Space out heavy operations instead of making many large calls simultaneously
- Cache data when possible instead of repeatedly querying the API
- Consider applying for higher rate tiers if you have legitimate high-volume needs
Is there a way to test API calls without spending real money?
Yes, a few options:
- Create campaigns with very small budgets (like $5/day) and immediately pause them
- Use development mode where only app admins can access test ad accounts
- Meta offers limited sandbox ad accounts for testing, though they have constraints
The safest approach for learning is to use a real ad account with minimal budget and create paused campaigns. Test your create/edit/delete workflows, then delete the test campaigns before they spend.
Ready to scale your Meta advertising with API-powered automation? Start with AdManage and launch your first batch of ads in minutes, not hours. Our platform handles all the API complexity so you can focus on creative testing and strategy.
Related Posts
Complete Guide to Facebook Ads Dashboard (2025)
Turn Facebook ads dashboard data into decisions. Master metrics, breakdowns, and automation that drive results in Meta Ads Manager.
Best Facebook Ads Reporting Tools: Complete Guide (2025)
Compare the best Facebook ads reporting tools for 2025. Learn which features matter, how to build your stack, and why clean data makes everything work.