List the ad accounts the token can access (id, name, currency, status).

List the Facebook Pages promotable on this ad account.

Returns page id + name. Use the page id for object_story_spec / asset_feed_spec when building creatives. Falls back to META_AD_ACCOUNT_ID if account_id is omitted.

List ad sets on the account, optionally filtered to one campaign.

Create an ABO ad set. daily_budget_cents is in cents ($50/day = 5000).

advantage_audience is forced OFF (0) inside the targeting spec so the audience is the one you defined. For video views use optimization_goal THRUPLAY + billing_event IMPRESSIONS. For lead gen use LEAD_GENERATION.

targeting is the Meta targeting spec dict, e.g.: {"geo_locations": {"countries": ["AU"]}, "age_min": 28, "age_max": 55, "flexible_spec": [{"interests": [{"id": "...", "name": "..."}]}]} Pass an empty flexible_spec / omit interests for a broad ad set.

Update an ad set (status, daily budget in cents, name).

List campaigns on the account (id, name, objective, status, budgets).

Create a campaign. Defaults to PAUSED - never set live without an explicit yes.

We use ABO (ad-set-level budgets), so no campaign budget is set here and is_adset_budget_sharing_enabled is forced false. objective must be one of the OUTCOME_* values. special_ad_categories (e.g. ["HOUSING","EMPLOYMENT","CREDIT"]) only when the account requires it, else pass none / [].

Update a campaign. Pass status ACTIVE to launch (get an explicit yes first), PAUSED to pause, DELETED to remove.

Create an ad creative from an ad-account-scoped video.

Two modes:

• Multi-variant (pass messages[], headlines[], descriptions[]): builds an asset_feed_spec creative. Meta shows "Primary text (1 of 5)" in Ads Manager. This is what you attach to ads via update_ad (step 4 of the flow).

• Single-variant (pass message + headline): builds an object_story_spec creative. Use this once as the placeholder to create ads against (step 2 of the flow).

video_id must be the ad-account-scoped id returned by upload_video (NOT a page-uploaded video id). image_url is a thumbnail - fetch it fresh right before this call (CDN urls expire); get_video_thumbnail gets one.

List ad creatives on the account (id, name, status).

Create an ad. For the DCO-bypass flow, pass the PLACEHOLDER creative_id here, then call update_ad to swap in the real multi-variant creative. Defaults PAUSED.

Update an ad. Swapping creative_id to a multi-variant creative here bypasses the DCO check (error 1885998) that blocks direct creation - this is step 4 of the flow.

List ads on the account, optionally filtered to one ad set.

Read performance. level is one of account/campaign/adset/ad. date_preset e.g. today, yesterday, last_7d, last_14d, last_30d, maximum. Returns spend, reach, clicks, ctr, cpc, cpm and the actions breakdown.

Search targetable interests by name. Returns id + name + audience_size for each, which you load into a flexible_spec interest stack on the interest ad set.

Upload a local video file to the ad account. Returns {"id": ""} - the ad-account-scoped video id you pass to create_ad_creative.

file_path is an absolute path to a local .mp4 (or similar). For large files Meta also supports a chunked/resumable flow; this does a straight multipart upload, which is fine for typical ad videos.

Fetch fresh thumbnail urls for a video. Meta CDN thumbnail urls expire fast, so call this immediately before create_ad_creative and use the returned uri as image_url. Returns the thumbnails list; the one with is_preferred=true is the pick.