Meta Ads

Meta Ads · Live

Ask Meta where the money is actually going.

Read Meta Ads campaigns, ad sets, creative, and insights across Facebook and Instagram so the agent can flag waste, surface winners, and reconcile spend with revenue.

Connect Meta AdsHow it worksLive
Auth
OAuth
Access
Read-only by default
Plan
Every plan
Freshness
Live — every call hits Meta's Marketing API
Available on
Every plan

Examples

Questions teams actually ask.

The tools it pulls from are shown inline — every answer in Lumen cites the underlying records it read.

Performance

Top 10 ad sets by ROAS last 7 days, and the bottom 5 — anything I should pause?

pullslistAdSetsgetInsights
Pacing

Daily spend vs. budget for every active campaign this week. Flag anything more than 20% off pace.

pullslistCampaignsgetInsights
Creative

Which ad creatives in the spring promo campaign drove the most conversions? Pull the creative thumbnails.

pullslistAdsgetAdCreativegetInsights

Scope

What Lumen sees. What it can change.

Read is on by default. Every write is a separate toggle, capped per user, and logged.

Read

What Lumen reads

Lumen calls Meta's Marketing API with the OAuth token you grant at install, scoped to the ad accounts you select. Read scope only by default.

  • Ad accounts

    List, currency, timezone, spend caps, business owner

  • Campaigns

    Definition, objective, status, budget, schedule

  • Ad sets

    Targeting, optimisation goal, bid strategy, daily budget, schedule

  • Ads & creatives

    Headline, primary text, link, thumbnail, status

  • Insights

    Impressions, clicks, spend, conversions, ROAS at every level (account / campaign / ad set / ad)

Write · opt-in

What Lumen can write

Lumen does not write to Meta Ads by default. Pause/unpause and budget changes can be admin-enabled per ad account if you want the agent to act on its own findings.

    Every call is logged with user, operation, ad-account ID, level, and date range. Exportable as CSV.

    Install

    Connect in under a minute.

    No keys, no call, no app marketplace fine print.

    1. Authorize
      01

      Connect with OAuth

      In Settings → Integrations → Meta Ads, click Connect. Sign in to Facebook and approve the ads_read scope. The token is stored encrypted.

    2. Pick ad accounts
      02

      Choose which ad accounts to expose

      Lumen will list every ad account your Business Manager exposes — pick only the ones the agent should query. You can change the selection later.

    3. Ask
      03

      Try a warm-up question

      Start with "ROAS by campaign last 7 days" — the agent will list active campaigns, pull insights for each, and rank them.

    Connect Meta Ads. Stop spend you don't want.

    OAuth. Read-only by default. Pause/budget writes opt-in.

    Connect Meta AdsBack to all integrations