Get performance insights for the ad account. Optionally set level=campaign, adset, or ad to break down results. Use since/until for date ranges. Returns metrics like impressions, clicks, spend, cpc, cpm, ctr, reach.

Get performance insights for a specific campaign by ID. Returns metrics like impressions, clicks, spend, cpc, cpm, ctr, reach.

Get performance insights for a specific ad set by ID. Returns metrics like impressions, clicks, spend, cpc, cpm, ctr, reach.

Get performance insights for a specific ad by ID. Returns metrics like impressions, clicks, spend, cpc, cpm, ctr, reach.

List campaigns in the ad account. Returns campaign name, status, objective, daily/lifetime budget, and bid strategy. Use effective_status to filter. Auto-paginates up to 10 pages.

List ad sets in the ad account. Optionally filter by campaign ID or effective status. Returns ad set name, status, targeting, budget, and schedule. Auto-paginates up to 10 pages.

List ads in the ad account. Optionally filter by ad set ID or effective status. Returns ad name, status, creative, and tracking info. Auto-paginates up to 10 pages.

Get details of the ad account — name, status, currency, timezone, spend cap, balance, and business info.

Create a new campaign. Requires name, objective, and status. Set special_ad_categories to [] if none apply. Budget can be set at campaign level (CBO) or at ad set level.

Update an existing campaign. Send only the fields you want to change. Cannot change objective after creation.

Delete a campaign. This is irreversible. Consider using update_campaign with status=ARCHIVED instead.

Create a new ad set within a campaign. Requires campaign_id, targeting, billing_event, optimization_goal, budget, and status. Targeting is a JSON string with age, gender, geo, interests, etc.

Update an existing ad set. Send only the fields you want to change.

Delete an ad set. This is irreversible. Consider using update_adset with status=ARCHIVED instead.

Create a new ad within an ad set. Requires adset_id and a creative_id (create the creative first with create_adcreative).

Update an existing ad. Change name, status, or swap creative.

Delete an ad. This is irreversible. Consider using update_ad with status=ARCHIVED instead.

Create an ad creative. The object_story_spec is a JSON string defining the creative content (image, video, or carousel with link_data or video_data). Requires a page_id.