Meta Ads

Run the full Meta advertising stack from AI agents: create and manage campaigns, ad sets, ads, and creatives, build customer-file custom audiences with automatic hashing, and pull Insights performance metrics for reporting, across 28 actions.

28 actions OAuth available

Meta Ads website ↗ Platform Documentation ↗ Capability data verified 2026-07-25

A product launch brief lands with approved creative assets and a budget cap

Upload Ad Image pushes the creative from FlowRunner file storage and returns its hash

Create Link Ad Creative assembles the single-image link ad from the Page, destination link, primary text, and image hash

Create Campaign and Create Ad Set build the structure with the objective, targeting, and budget in minor currency units, everything defaulting to Paused

Create Ad links the creative into the ad set, also paused

The marketing lead reviews the targeting spec, the budget math, and the rendered creative before anything can spend a cent

Update Campaign activates delivery on approval

Get Insights runs daily, flagging spend pace and cost-per-result drift back to the channel

What This Integration Enables

Meta's Marketing API encodes a piece of hard-won wisdom in its defaults: campaigns, ad sets, and ads are created Paused, because programmatic access to an ad account is programmatic access to a credit card. FlowRunner's architecture takes that hint seriously. Agents do the assembly, the audience plumbing, and the reporting across 28 actions, and the flip that starts spend belongs to a person. - Structure: campaigns, ad sets, and ads built from briefs with objectives, optimization goals, and targeting specs - Creative: images uploaded from FlowRunner file storage, link ad creatives assembled from friendly fields and Page identity - Audiences: customer-file custom audiences created and refreshed from CRM data, with emails and phones normalized and SHA-256 hashed automatically - Reporting: Get Insights at account, campaign, ad set, or ad level feeding dashboards, alerts, and budget reviews One number worth internalizing before automating anything here: budgets, bids, and balances are in minor currency units, 5000 means fifty dollars, while Insights spend comes back in major units. Agents handle that conversion consistently; humans checking an agent's work through a [human-in-the-loop](/concepts/human-in-the-loop) gate is what catches the case where a brief said one thing and a field meant another.

Without FlowRunner

Campaign builds are click marathons Every launch means an afternoon in Ads Manager assembling the same structure by hand

Audiences go stale between exports The retargeting audience reflects the CRM as of whenever someone last uploaded a CSV

Overspend is discovered on the invoice Nobody watches daily spend against plan until the month closes and the number is wrong

With FlowRunner

Campaigns assemble themselves, paused Agents build campaign, ad set, ad, and creative from a brief, and nothing delivers until a person flips it live

Audiences refresh from the source CRM changes flow into custom audiences on schedule, hashed automatically on the way

Spend is watched every morning Insights pull daily, and pace or cost anomalies reach the team while the budget can still be saved

Use Case Scenarios

Launch structure from a brief, live only after review

The launch brief lives in [Notion](/integrations/notion) with copy, link, image, and budget. The agent uploads the image, builds the creative against the brand's Page from List My Pages, and assembles campaign, ad set, and ad, all paused, with the budget converted to minor units and double-written into the review summary in both formats. The marketing lead reviews one summary: audience, placement, daily budget in dollars, creative preview. Approval flips the campaign active through Update Campaign. Launch day assembly takes minutes, and the only human minutes spent are the ones that need judgment.

Retargeting audiences that track the CRM, not the last export

Nightly, the agent reads customer changes from [HubSpot](/integrations/hubspot): new trial signups join the nurture audience through Add Users to Audience, closed-won accounts leave the prospecting audience through Remove Users from Audience so ad spend stops chasing people who already bought. Plain emails and phone numbers go in; the integration normalizes and SHA-256 hashes each value before it touches Meta, as the platform requires. The audiences that targeting depends on stop being snapshots and become live views of the CRM.

The morning spend watch with teeth

Every morning, Get Insights pulls impressions, clicks, CTR, spend, and cost per result for each active campaign, appending to the performance workbook in [Google Sheets](/integrations/google-sheets). The agent compares spend pace against each campaign's plan and cost-per-result against its threshold, and posts exceptions to [Slack](/integrations/slack) with the trend attached. The team decides what to do, and the agent executes it: Update Ad Set to trim a budget, Update Ad to pause a fatigued creative. The monthly invoice stops containing surprises because every day's number was already seen.

Human-in-Loop Highlight

The status flip from Paused to Active is where this integration touches money, and it deserves the respect the API's own defaults suggest. Update Campaign and Update Ad Set can start delivery and change budgets, and budgets live in minor currency units: a value of 500000 is five thousand dollars a day, not five hundred, and the API will accept either without comment. Activation in FlowRunner is therefore always a human decision made against a summary that shows the budget in both units, the targeting in plain language, and the creative as it will render. The same gate holds for the destructive tail: Delete Campaign takes every ad set and ad under it, Delete Custom Audience silently removes the audience from any ad set targeting it, and neither can be undone. Agents propose, with the blast radius stated; people activate and delete.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

Agent Capabilities

28 actions

Ad Accounts

List Ad Accounts Lists accessible ad accounts with status, currency, timezone, amount spent, and balance, monetary fields in minor units.
Get Ad Account Retrieves one account including spend cap and business, with the act_ prefix normalized automatically.

Campaigns

List Campaigns Lists an account's campaigns with objective, status, effective status, budgets, and schedule.
Get Campaign Retrieves one campaign including buying type and special ad categories.
Create Campaign Creates a campaign with an outcome-based objective, defaulting to Paused so nothing spends until activated.
Update Campaign Renames, pauses, activates, or rebudgets a campaign; empty fields stay unchanged. The activation flip behind this page's human gate.
Delete Campaign Permanently deletes a campaign and every ad set and ad under it. Cannot be undone.

Ad Sets

List Ad Sets Lists ad sets account-wide or scoped to a campaign, with budgets and optimization settings.
Get Ad Set Retrieves one ad set including bid strategy, targeting spec, and promoted object.
Create Ad Set Creates an ad set with exactly one of daily or lifetime budget in minor units, optimization goal, billing event, and targeting.
Update Ad Set Adjusts budgets, bids, optimization goal, or targeting; also human-gated when the change starts or increases spend.
Delete Ad Set Permanently deletes an ad set and its ads. Cannot be undone.

List Ads Lists ads account-wide or scoped to an ad set, with status and creative reference.
Get Ad Retrieves one ad with its creative and effective status.
Create Ad Creates an ad linking an existing creative into an ad set, defaulting to Paused.
Update Ad Renames an ad or changes its delivery status: pause, activate, or archive.
Delete Ad Permanently deletes an ad. Cannot be undone.

Creatives

List Ad Creatives Lists an account's creatives with title, body, story spec, and thumbnail.
Get Ad Creative Retrieves one creative including image hash and URLs.
Create Link Ad Creative Builds a single-image link ad creative from friendly fields: Page, destination link, primary text, headline, and image hash.

Ad Images

Upload Ad Image Uploads an image from a FlowRunner file to the account's image library and returns its hash for creative assembly.

Insights

Get Insights Retrieves performance metrics for an account, campaign, ad set, or ad, aggregated at the chosen level. Spend and cost metrics return in major currency units. The reporting engine behind every dashboard and alert this page describes.

Custom Audiences

List Custom Audiences Lists an account's custom audiences with subtype, approximate size, and delivery status.
Create Custom Audience Creates a customer-file custom audience ready to be populated with hashed contacts.
Add Users to Audience Adds users from plain emails or phone numbers, normalized and SHA-256 hashed automatically before sending.
Remove Users from Audience Removes users by the same normalize-and-hash process, keeping suppression in sync with reality.
Delete Custom Audience Permanently deletes an audience; ad sets targeting it silently lose it. Human-gated.

Frequently Asked Questions

What can FlowRunner do with Meta Ads?

FlowRunner agents can run List Ad Accounts, Get Ad Account, and List Campaigns in Meta Ads, plus 25 more actions.

Does connecting Meta Ads to FlowRunner require OAuth?

Yes. Meta Ads connects to FlowRunner with OAuth 2.0, so agents authenticate without handling raw credentials.

Can Meta Ads trigger a FlowRunner workflow automatically?

Meta Ads doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.

Start building with Meta Ads

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us