Meta Ads

Overview

Connecting Meta Ads lets the dashboard:

Create, update, pause, resume, and remove campaigns, ad sets, and ads.
Upload creative assets (image, video, carousel) into the connected ad account.
Metrics sync for this platform is not available yet.
Run native creative experiments via Meta’s A/B Split Test feature.
Receive realtime ad-disapproval and account-status events via webhooks.

The integration uses the Graph API v19.0 with OAuth 2.0 authentication.

Prerequisites

Before connecting, make sure you have:

A Meta Ads account in good standing.
Admin role on the Meta Business account that owns the ad account.
(Optional) A Meta Pixel or Conversions API source if you want conversion-based optimization.

OAuth scopes

The connection requests:

ads_management
ads_read
business_management

Connect

Open the Paid UA → Integrations page in the dashboard.
Click Connect on the Meta Ads tile.
Sign in with the Facebook account that has access to your Business Manager.
Approve the requested scopes.
Pick the ad account to use.

The dashboard exchanges the short-lived user token for a long-lived token (60-day expiry); it is rotated automatically before expiry, so you don’t need to reconnect manually unless the user revokes scope.

What lives on the platform vs the dashboard

Lives on Meta	Lives on the dashboard
Campaign / ad-set / ad ids	Spend caps are checked on every campaign create and budget change, from the console, the assistant or an agent, and on resuming a campaign created through AppDNA; the Daily Budget Cap totals the active campaigns created through AppDNA (on Paid UA → Campaigns, by the assistant or an agent, and a split test’s per-variant campaigns); lowering a budget is never refused; what is left of a lifetime budget (less the spend recorded for it) is checked per day over the days left up to its end date (the end of that day in UTC), which is sent to Meta as the campaign’s stop time, and a lifetime split test run as one campaign per variant sends each campaign the test’s end; budgets and caps are in the ad account’s currency and nothing is converted, so caps across ad accounts in different currencies aren’t comparable; running spend is not monitored yet
Creative library	Vendor-neutral creative briefs
Audience configurations	Idempotency keys + retry attempts
Insights (spend / impressions / clicks)	Metrics are not synced yet

Webhooks

Meta posts ad-status, account-status, and disapproval events to:

POST /api/v1/webhooks/meta-ads

Signature: X-Hub-Signature-256 HMAC-SHA256 over the raw body, verified with a platform-managed signing secret configured by your administrator. A previous signing secret is also accepted during key rotation.

Disconnect

Disconnecting revokes the dashboard’s stored OAuth token and stops all background syncs. Campaigns created via the dashboard remain on the platform — disconnect does not pause or delete them. While the account is disconnected, AppDNA can’t pause, resume or change its campaigns, and they keep running and spending on Meta. Pausing one from its campaign page asks you to reconnect. If you can’t reconnect, Stop tracking in AppDNA on that page takes the campaign out of the Daily Budget Cap total and the guardrails. It doesn’t pause or delete anything on Meta; pause it there to stop the spend. Once the account is connected again, Track again on that page brings the campaign back as active, so it counts in the Daily Budget Cap total at once; if it’s paused on Meta, pause it in AppDNA afterwards. Until then, AppDNA refuses every other change to it.

Limits

Token rotation: long-lived token, rotated automatically before expiry.
Rate limits: per-ad-account token bucket; 429s are retried with exponential backoff.
Creative size: image up to 8 MB, video up to 4 GB; format-specific limits enforced server-side before upload.

Getting Started

Console

Paid UA Integrations

Inbound integrations

Overview

Prerequisites

OAuth scopes

Connect

What lives on the platform vs the dashboard

Webhooks

Disconnect

Limits

​Overview

​Prerequisites

​OAuth scopes

​Connect

​What lives on the platform vs the dashboard

​Webhooks

​Disconnect

​Limits

Overview

Prerequisites

OAuth scopes

Connect

What lives on the platform vs the dashboard

Webhooks

Disconnect

Limits