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
- Go to Meta Business Suite → Ads Manager
- Note your Ad Account ID (shown in the account dropdown — starts with
act_) - Go to developers.facebook.com → your app → Graph API Explorer
- Generate an access token with the
ads_managementandads_readpermissions - In Phyllax → Integrations → Meta Ads → Connect → paste the access token and ad account ID
Required Credentials
| Field | Where to find it |
|---|---|
| Access Token | developers.facebook.com → Graph API Explorer → Generate token with ads_management, ads_read |
| Ad Account ID | Meta 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
| Schedule | What it checks |
|---|---|
| Ad spend over budget | Ad sets or campaigns approaching or exceeding their daily budget |
| Disapproved ads | Ads recently disapproved or flagged for policy violations |
| Low performing ads | Ads with low CTR or high cost per result |
| Campaign results | Today'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.