Adbloop

Create Campaign

Create ONE Meta campaign (created PAUSED for review). Free-plan friendly — counts toward your monthly campaign limit. To launch many at once or from a Drive folder, use bulk_create_campaigns (Pro). Needs a public imageUrl (or Drive/Dropbox share link) for image ads. WRITES live.

Create Structured

Create ONE campaign with MULTIPLE ad sets and MULTIPLE ads each (1 campaign -> N ad sets -> M ads), image or video, including DPA/Catalog dynamic product ads. Created PAUSED. Honors spend guardrails. Pro feature. WRITES live.

Get Ad Accounts

List the Meta ad accounts connected to this Adbloop user, with the Page NAME + Instagram username + pixel each account uses. Use this to resolve a spoken account/page name to IDs.

List Drive Folder

List the images/videos inside a PUBLIC Google Drive folder (must be shared as 'Anyone with the link'). Returns each file's name and a Drive URL usable directly as imageUrl in bulk_create_campaigns. Perfect for 'create one campaign per image in this folder'. Read-only.

Get Insights

Rate-limit-safe Meta performance metrics (spend, impressions, clicks, CTR, leads, purchases, ROAS). Read-only.

List Campaigns

List existing campaigns with status, budget, effective status. Read-only.

List Adsets

List ad sets — across the account or inside one campaign. Shows budget, optimization goal, status. Read-only.

List Ads

List ads — across the account or inside one ad set. Includes creative preview info. Read-only.

Get Campaign Structure

Full tree of one campaign: its ad sets and every ad inside each. Read-only.

Add Ad To Adset

Add a NEW ad (with creative) to an EXISTING ad set. Created PAUSED. Accepts either an existing creative_id, a library image_hash (this is where saved library creatives CAN be used), or ad copy fields. WRITES live.

Pause Campaigns

Pause campaigns/ad sets/ads by ID. Reversible.

Resume Campaigns

Resume (activate) paused campaigns/ad sets/ads by ID. Turns spend ON.

Delete Campaigns

PERMANENTLY delete campaigns/ad sets/ads by ID. Irreversible — requires confirm:true. Use pause instead if unsure.

Update Campaign Budget

Change the daily budget (and/or rename) of an existing campaign or ad set. The account is required so the new budget is checked against your spend guardrails. WRITES live.

Search Targeting

Search Meta's targeting interests by keyword (e.g. 'yoga', 'small business owners'). Returns interest names, IDs, and audience sizes — useful when planning campaigns. Read-only.

Get Lead Forms

List the lead-gen forms available on a Facebook Page (for OUTCOME_LEADS campaigns). Read-only.

Get Creative Library

List the user's saved creatives. NOTE: image_hash works with add_ad_to_adset, but bulk_create_campaigns needs a public imageUrl (or Drive/Dropbox link). Read-only.

Estimate Bulk Create

Estimate how long bulk creation will take for N campaigns. Read-only.

Get Guardrails

View the spend safety limits for an account. Read-only. Editable only by the owner in Adbloop settings.

Check Capacity

Check an ad account's current Meta API rate-limit headroom BEFORE a bulk run. Read-only. Returns GO/TIGHT/SPLIT/WAIT_OR_SPLIT/WAIT + utilization + regain minutes.

Validate Campaigns

Pre-flight check campaign rows BEFORE creating. Read-only. Per-row verdict: will_create / will_create_with_changes / will_fail. Pass meta_account_id to also check spend guardrails.

Bulk Create Campaigns

Create many Meta campaigns at once on ONE account (rate-limit-safe, validated). WRITES live. Honors plan limits, spend guardrails, and capacity. Auto-uses the correct Page/Instagram/pixel. Each campaign needs an imageUrl (public image, or Drive/Dropbox share link).

Bulk Create Multi Account

Launch the SAME campaign set across MULTIPLE ad accounts in one call (up to 5 accounts; chain calls for more). Each account gets its own currency-aware guardrails, capacity check (throttled accounts are skipped, not hammered), and correct Page/Instagram/pixel. WRITES live.