List campaigns in the ad account. Supports filtering by status and objective. Returns paginated results.

Get details of a specific campaign by ID.

Create a new ad campaign. Defaults to PAUSED status. Requires name and objective. Budget can be set at campaign or ad set level.

Update an existing campaign. Only provided fields will be modified.

Delete a campaign. This action is irreversible.

Copy an existing campaign. Creates a duplicate with optional name override. Copies structure including ad sets and ads.

Get all ad sets belonging to a specific campaign.

Get all ads belonging to a specific campaign.

Get leads generated by a specific campaign. Requires leads_retrieval permission.

List ad sets in the ad account. Optionally filter by campaign or status.

Get details of a specific ad set by ID.

Create a new ad set. Requires name, campaign_id, budget, optimization_goal, billing_event, and targeting. Defaults to PAUSED status.

Update an existing ad set. Only provided fields will be modified.

Delete an ad set. This action is irreversible.

Copy an existing ad set. Creates a duplicate within the same or different campaign.

Get human-readable targeting description for an ad set. Converts targeting spec into readable sentences.

Get all ads belonging to a specific ad set.

Get leads generated by a specific ad set. Requires leads_retrieval permission.

List ads in the ad account. Optionally filter by campaign, ad set, or status.

Get details of a specific ad by ID.

Create a new ad. Requires name, adset_id, and creative (JSON object_story_spec). Defaults to PAUSED status.

Update an existing ad. Only provided fields will be modified.

Delete an ad. This action is irreversible.

Copy an existing ad. Creates a duplicate within the same or different ad set.

Get a preview of an ad in a specific format. Returns HTML iframe for rendering.

Get delivery estimate for an ad including estimated daily reach and cost.

List ad creatives in the ad account.

Get details of a specific ad creative by ID.

Create a new ad creative with object_story_spec. The spec defines the ad content (link, photo, or video) and the associated Facebook Page.

Update an existing ad creative. Only name and url_tags can be modified after creation.

Create a dynamic creative with asset_feed_spec. Meta automatically combines different images, videos, titles, bodies, and CTAs to find the best performing combinations.

Generate an ad preview without needing an existing ad. Provide creative spec directly to see how it would look.

List ad images uploaded to the ad account.

Upload an ad image from a public URL or a local file path. Returns image hash for use in ad creatives.

Get details of a specific ad image by ID.

Delete an ad image by hash. This action is irreversible.

List ad videos uploaded to the ad account.

Upload an ad video from a public URL or a local file path. Returns video ID for use in ad creatives.

Get details of a specific ad video by ID.

Delete an ad video. This action is irreversible.

List Instant Experience (Canvas) creatives in the ad account.

Get details of a specific Instant Experience (Canvas) by ID.

Create a new Instant Experience (Canvas) on a Facebook Page. Requires page_id and body_elements JSON array defining the canvas layout.

Delete an Instant Experience (Canvas). This action is irreversible.

List custom audiences in the ad account.

Get details of a specific custom audience by ID.

Create a new custom audience. Subtype determines the audience source (CUSTOM, WEBSITE, APP, OFFLINE_CONVERSION, LOOKALIKE, ENGAGEMENT, etc.).

Update an existing custom audience. Only provided fields will be modified.

Delete a custom audience. This action is irreversible.

Add users to a custom audience. Payload must be a JSON string containing hashed user data with a schema array defining the data types (e.g. EMAIL, PHONE, FN, LN).

Remove users from a custom audience. Payload format is the same as add_users_to_audience.

Create a lookalike audience based on an existing custom audience. Ratio (1-10) determines how closely the new audience resembles the source.

Get health status and delivery readiness of a custom audience. Shows match rate, size, and operation status.

List saved audiences in the ad account. Saved audiences are reusable targeting presets.

Get details of a specific saved audience by ID.

Search for targeting options (interests, behaviors, demographics, etc.) by keyword. Use this to find valid targeting IDs for ad set targeting specs.

Search for geographic locations (countries, regions, cities, zip codes) for ad targeting.

Map targeting IDs to their full details (names, types, paths). Useful for resolving IDs obtained from other endpoints.

Get estimated audience reach for a given targeting specification. Useful for planning campaigns before creating them.

Get targeting suggestions based on existing targeting criteria. Meta suggests related interests, behaviors, and demographics.

Get performance insights for the ad account. Returns metrics like impressions, clicks, spend, reach, etc.

Get performance insights for a specific campaign.

Get performance insights for a specific ad set.

Get performance insights for a specific ad.

Create an async insight report for large data queries. Returns a report_run_id to poll with get_async_report.

Check status and retrieve results of an async insight report.

Get leads submitted through a lead generation form.

Get details of a specific lead by ID.

List lead generation forms for a Facebook Page.

Create a new lead generation form on a Facebook Page. Requires pages_manage_ads permission.

Get details of a specific lead generation form.

List product catalogs for the ad account.

Get details of a specific product catalog.

Create a new product catalog for the ad account.

Update an existing product catalog.

List product sets within a catalog.

Create a new product set within a catalog.

Get details of a specific product set.

Update an existing product set.

List products within a catalog.

Get details of a specific product.

Update an existing product in a catalog.

Batch create, update, or delete products in a catalog. Supports up to 5,000 items per request. Update operations support upsert.

Check the status of a catalog batch operation.

List product feeds for a catalog.

Create a new product feed for a catalog.

Upload/trigger a feed file upload for a product feed.

Get upload history for a product feed.

List automated rules for the ad account.

Get details of a specific automated rule.

Create a new automated rule for the ad account.

Update an existing automated rule.

Delete an automated rule.

List A/B test experiments (ad studies) for the ad account.

Create a new A/B test experiment (ad study).

Get details of a specific experiment (ad study).

Update an existing experiment (ad study).

Get results/cells of an experiment (ad study).

Send a server-side conversion event via the Conversions API (pixel).

Send an offline conversion event to an offline event set.