Skip to content

Meta Ads

Monitor your Meta (Facebook & Instagram) ad campaigns for budget overruns, disapproved ads, and performance issues. Catch problems before they waste your ad spend.

Quick Setup

  1. Go to Meta Business SuiteAds Manager
  2. Note your Ad Account ID (shown in the account dropdown — starts with act_)
  3. Go to developers.facebook.com → your app → Graph API Explorer
  4. Generate an access token with the ads_management and ads_read permissions
  5. In Phyllax → Integrations → Meta Ads → Connect → paste the access token and ad account ID

Required Credentials

FieldWhere to find it
Access Tokendevelopers.facebook.com → Graph API Explorer → Generate token with ads_management, ads_read
Ad Account IDMeta Business Suite → Ads Manager → Account dropdown (act_...)

Token expiration

Graph API Explorer tokens expire in about 1 hour. For long-term use, exchange for a long-lived token or use a System User token from Meta Business Manager, which doesn't expire.

What Phyllax Monitors

ScheduleWhat it checks
Ad spend over budgetAd sets or campaigns approaching or exceeding their daily budget
Disapproved adsAds recently disapproved or flagged for policy violations
Low performing adsAds with low CTR or high cost per result
Campaign resultsToday's performance summary — spend, impressions, clicks, conversions

Notification Actions

When Meta Ads finds something important, the notification card shows:

  • Pause campaign — pause the underperforming or over-budget campaign
  • Increase budget — adjust the daily or lifetime budget
  • Fix ad — edit the ad creative or copy
  • Submit appeal — appeal a disapproved ad
  • View report — open the campaign report in Ads Manager

All action chips that involve writing open the AI draft panel — AI generates a suggested response that you can edit before posting.

Troubleshooting

"OAuthException: Invalid access token"

Your access token has expired. Generate a new one from Graph API Explorer or use a System User token for permanent access.

"Ad account not found"

Make sure the Ad Account ID includes the act_ prefix (e.g. act_123456789). The ID without the prefix won't work.

"Insufficient permissions"

Your access token needs ads_management and ads_read permissions. Generate a new token with these scopes from Graph API Explorer.

Phyllax — a local desktop sentinel for your work tools