Facebook Ads integration
Meta Marketing API for managing Facebook and Instagram advertising campaigns. Create and manage campaigns, ad sets, ads, audiences, and creatives. Access insights, reporting, and targeting options for comprehensive ad management.
Say what should happen.
The workflow builds itself.
Common Facebook Ads use cases
- automate ad management
- automate ad set management
- automate campaign management
- automate ad creative management
- automate custom audience management
- automate ad account management
- get ad programmatically
- list ad programmatically
- create ad programmatically
- delete ad programmatically
What you can do with Facebook Ads
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Ad, 5 operations
create_adCreate adPOSTCreate a new ad under an ad account. An ad links a creative to an ad set and controls the delivery statusdelete_adDelete adDELETEDelete an ad. This sets the ad status to DELETED. The ad and its data can still be retrieved but it will stop runningget_adGet adGETRetrieve details of a specific ad including its name, status, creative reference, and associated ad set and campaignlist_adsList adsGETList all ads for an ad account. Ads are the individual creative units that users see, each belonging to an ad setupdate_adUpdate adPOSTUpdate an existing ad's properties such as name or status
Ad set, 5 operations
create_ad_setCreate ad setPOSTCreate a new ad set under an ad account. Ad sets control targeting, budget, schedule, and bidding for the ads within themdelete_ad_setDelete ad setDELETEDelete an ad set. This sets the ad set status to DELETED. The ad set and its data can still be retrieved but ads will stop runningget_ad_setGet ad setGETRetrieve details of a specific ad set including targeting, budget, schedule, and optimization settingslist_ad_setsList ad setsGETList all ad sets for an ad account. Ad sets define the targeting, budget, schedule, and bidding for ads within a campaignupdate_ad_setUpdate ad setPOSTUpdate an existing ad set's properties such as name, status, budget, or targeting parameters
Campaign, 5 operations
create_campaignCreate campaignPOSTCreate a new advertising campaign under the specified ad account. Requires a name, objective, and special ad categories at minimumdelete_campaignDelete campaignDELETEDelete a campaign. This sets the campaign status to DELETED. The campaign and its data can still be retrieved but it will no longer runget_campaignGet campaignGETRetrieve details of a specific campaign including its name, objective, status, budget, and bid strategylist_campaignsList campaignsGETList all campaigns for an ad account with optional filtering by status, objective, or date. Supports pagination for large result setsupdate_campaignUpdate campaignPOSTUpdate an existing campaign's properties such as name, status, budget, or bid strategy
Ad creative, 3 operations
create_ad_creativeCreate ad creativePOSTCreate a new ad creative with text, images, videos, or carousel content. Creatives are reusable across multiple adsget_ad_creativesGet ad creativesGETList all ad creatives for an ad account. Creatives contain the visual and text content displayed in adsupdate_ad_creativeUpdate ad creativePOSTUpdate properties of an existing ad creative such as its name or status
Custom audience, 3 operations
create_custom_audienceCreate custom audiencePOSTCreate a custom audience for targeting. Custom audiences can be based on customer lists, website visitors, app activity, or engagementdelete_custom_audienceDelete custom audienceDELETEDelete a custom audience by its IDlist_custom_audiencesList custom audiencesGETList all custom audiences for an ad account including their size, status, and creation details
Ad account, 2 operations
get_ad_accountGet ad accountGETRetrieve details of a specific ad account including name, currency, timezone, spend cap, and account statuslist_ad_accountsList ad accountsGETList all ad accounts the current user has access to
Ad account insight, 1 operation
get_ad_account_insightsGet ad account insightsGETRetrieve aggregated performance insights across all campaigns in an ad account. Useful for account-level reporting and spend tracking
Ad image, 1 operation
upload_ad_imageUpload ad imagePOSTUpload an image to an ad account's image library to be referenced from ad creatives. Provide the image as Base64-encoded bytes
Ad insight, 1 operation
get_ad_insightsGet ad insightsGETRetrieve performance insights and metrics for a specific ad including impressions, clicks, spend, and conversion data
Ad preview, 1 operation
get_ad_previewGet ad previewGETGet an HTML preview of an ad in a given placement format
Ad set insight, 1 operation
get_ad_set_insightsGet ad set insightsGETRetrieve performance insights and metrics for a specific ad set including impressions, clicks, spend, and conversion data
Ad video, 1 operation
upload_ad_videoUpload ad videoPOSTUpload a video to an ad account's video library to be referenced from ad creatives. Provide a publicly accessible video URL
Campaign insight, 1 operation
get_campaign_insightsGet campaign insightsGETRetrieve performance insights and metrics for a specific campaign. Returns data like impressions, clicks, spend, conversions, CPC, CPM, and CTR
Page, 1 operation
list_pagesList pagesGETList the Facebook Pages the current user manages
Pixel, 1 operation
list_pixelsList pixelsGETList the Meta Pixels associated with the given ad account
Targeting search, 1 operation
get_targeting_searchGet targeting searchGETSearch for targeting options such as interests, behaviors, demographics, and employers. Use to find valid targeting IDs for ad set creation
Use Facebook Ads from Claude Code, Cursor or Codex
Connect Facebook Ads in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Facebook Ads operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Facebook Ads
- Create your workspace
Sign up free. Nothing to install.
- Connect Facebook Ads once
Add your Facebook Ads connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Facebook Ads integration FAQ
What can you do with the Facebook Ads integration?
LiveContext exposes 33 operations on Facebook Ads, covering ad, ad set, campaign and ad creative. Common uses include automate ad management, automate ad set management and automate campaign management.
