Skip to main content

​
Prerequisites

​
Connecting Meta Ads

Once you’ve set up Adspirer with your AI client, connect Meta:
  1. Open your AI assistant (ChatGPT, Claude, Claude Code, etc.)
  2. Say: “Connect my Meta Ads account”
  3. Adspirer opens your browser for OAuth authorization
  4. Sign in to Meta Business Manager and select the ad account you want to manage
  5. Approve permissions (read campaign data, create ads, manage budgets)
Verify the connection: 
Check my connected ad platforms
You should see your Meta ad account listed with account name, ID, and active status.

​
What You Can Do (36 Tools)

​
Performance Analysis

  • get_meta_campaign_performance — Pull metrics for campaigns, ad sets, or individual ads
  • analyze_meta_ad_performance — Deep analysis of ad-level performance with recommendations
  • get_meta_audience_insights — Audience breakdown by age, gender, and interests
  • analyze_meta_audiences — See which audience segments perform best
  • analyze_meta_wasted_spend — Identify campaigns with poor ROAS and recommend cuts
  • detect_meta_creative_fatigue — Identify ads losing effectiveness over time
  • explain_meta_anomaly — Diagnose sudden changes in performance (CPA spikes, CTR drops)
  • get_meta_ad_creatives — View creative details for ads in a campaign

​
Targeting & Research

  • search_meta_targeting — Find audiences by interests, demographics, behaviors
  • browse_meta_targeting — Explore Meta’s targeting categories
  • list_meta_custom_audiences — View existing custom audiences (database lists, lookalikes, website, engagement)

​
Campaign Creation

  • select_meta_campaign_type — Choose between Image, Video, or Carousel based on your creative
  • discover_meta_assets — Check if you have existing creatives in Meta
  • validate_and_prepare_meta_assets — Verify images/videos meet Meta’s requirements (dimensions, file size, aspect ratio)
  • create_meta_image_campaign — Launch single-image campaigns (supports lifetime budgets, end dates, placement controls)
  • create_meta_video_campaign — Launch video campaigns (supports lifetime budgets, end dates, placement controls)
  • create_meta_carousel_campaign — Launch multi-card carousel campaigns (supports lifetime budgets, end dates, placement controls)
  • create_meta_dco_ad — Create dynamic creative optimization ads
  • duplicate_meta_campaign — Duplicate an existing campaign with optional modifications

​
Lead generation

  • list_meta_lead_forms — View lead forms configured in your ad account
  • get_meta_lead_form_submissions — Pull lead submissions from a specific form

​
Account & pixel management

  • list_meta_instagram_accounts — View connected Instagram accounts
  • list_meta_pixels — View Meta Pixels configured in your ad account

​
Optimization

  • optimize_meta_budget — Reallocate budget based on ROAS or CPA performance
  • optimize_meta_placements — Shift spend to best-performing placements (Feed, Stories, Reels, etc.)

​
Ad set & ad management

  • add_meta_ad_set — Add ad sets to existing campaigns (supports lifetime budgets, end dates, placements, multi-advertiser opt-out)
  • add_meta_ad — Add ads to existing ad sets
  • update_meta_campaign — Change budgets, bids, or targeting
  • update_meta_ad_set — Update ad set budgets, targeting, or schedule
  • update_meta_ad — Update ad creative or status
  • pause_meta_campaign — Stop campaigns or ad sets
  • resume_meta_campaign — Restart paused campaigns
  • list_meta_campaigns — List all campaigns with status and budget
  • get_meta_campaign_details — Detailed campaign info
  • list_meta_ad_sets — List ad sets in a campaign
  • list_meta_ads — List ads in an ad set

​
Campaign Creation Workflow

Meta campaigns follow a 6-step workflow. Skip steps and the campaign will fail validation. 
1. get_connections_status
   ↓ (verify you're managing the right Meta account)
2. search_meta_targeting
   ↓ (find your target audience)
3. select_meta_campaign_type
   ↓ (image, video, or carousel?)
4. discover_meta_assets
   ↓ (check existing creatives)
5. validate_and_prepare_meta_assets
   ↓ (verify asset URLs meet Meta requirements)
6. create_meta_*_campaign
   ↓ (image/video/carousel — campaign created PAUSED)

​
Example Prompts

​
Analyze Performance

Pull Meta Ads metrics and flag underperforming campaigns.

CursorOpen in Cursor

​
Detect Creative Fatigue

Find fatigued creatives with declining click-through rates.

CursorOpen in Cursor

​
Create an Image Campaign

Meta image campaign with creative validation and audience targeting.

CursorOpen in Cursor

​
Optimize Placements

Compare CPA across Feed, Stories, Reels and recommend shifts.

CursorOpen in Cursor

​
Audience Analysis

Audience breakdown by demographics and interest-based ROAS.

CursorOpen in Cursor

​
Creative Assets: What You Need to Know

Adspirer does NOT generate images or videos. You provide the creative URLs.

​
Supported Asset Sources

  • Google Drive (public or shared links)
  • Dropbox (public links)
  • Amazon S3 (public URLs)
  • Any publicly accessible image/video URL

​
Meta’s Creative Requirements

The validate_and_prepare_meta_assets tool checks these automatically:
  • Image ads: 1080x1080px minimum, JPG or PNG, under 30MB, 1:1 or 4:5 aspect ratio
  • Video ads: 1080x1080px minimum, MP4 or MOV, under 4GB, 1:1 or 4:5 or 9:16 aspect ratio, 1-240 seconds
  • Carousel ads: 2-10 cards, each 1080x1080px, JPG or PNG
  • Text limits: Primary text 125 chars (recommended), headline 27 chars, description 30 chars

​
Budget Guidelines

  • Minimum: $5/day per ad set (Meta’s requirement)
  • Recommended: $20+/day for meaningful data
  • Testing: Start with $30/day split across 2-3 ad sets to find winners
  • Scaling: Once you find ROAS above 3.0, increase budget 20-30% every 3 days

​
Best Use Cases for Meta Ads

  • E-commerce: Visual products (fashion, home goods, beauty)
  • Demand generation: Reach cold audiences with interest-based targeting
  • Retargeting: Re-engage website visitors, cart abandoners
  • Video storytelling: Brand awareness campaigns with Reels or Stories
  • Lead generation: On-platform forms (though LinkedIn often performs better for B2B)

​
Troubleshooting

​
”Ad account not connected” error

Re-authenticate your Meta Business Manager: 
Connect my Meta Ads account
Make sure you select the correct ad account during OAuth. If you manage multiple accounts, you may need to reconnect with admin permissions.

​
”Asset validation failed” error

Common causes:
  • Image/video URL is private (not publicly accessible)
  • Wrong dimensions (Meta requires minimum 1080x1080px)
  • File too large (30MB for images, 4GB for video)
  • Unsupported format (use JPG/PNG for images, MP4/MOV for video)
Run validation separately to diagnose: 
Validate this Meta creative: [your URL]

​
“Campaign creation failed” error

Most common reason: skipping workflow steps. Meta campaigns require all 6 steps in order. If you jump straight to create_meta_image_campaign without running validate_and_prepare_meta_assets first, it will fail. If you’re using agent skills, the AI enforces the correct workflow automatically.

​
Creative fatigue detection not working

The tool needs at least 14 days of data per ad. If your ads are newer, it can’t detect fatigue yet. Wait until ads have run for 2+ weeks.

​
FAQ

No. Meta treats Facebook and Instagram as placement options within the same campaign. When you create a Meta campaign through Adspirer, you choose placements (Feed, Stories, Reels, etc.) that span both platforms. You can’t create Instagram-only campaigns through the API.
No. Adspirer manages campaigns, not creative production. You provide image/video URLs. For AI-generated creatives, use tools like Midjourney, DALL-E, or Runway, then upload to Google Drive/Dropbox and provide the link.
Yes. Create multiple ad sets with different creatives (different image URLs) but the same targeting and budget. After 7 days, use analyze_meta_ad_performance to see which creative wins, then pause the losers and scale the winner.
Meta Ads: Best for demand generation (reaching people who don’t know you exist) and visual products. Interest-based targeting. Lower intent but cheaper clicks.Google Ads: Best for demand capture (reaching people actively searching for solutions). Keyword-based targeting. Higher intent but more expensive clicks.
Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: 49/mofor150calls.Pro:49/mo for 150 calls. Pro: 99/mo for 600 calls. Max: $199/mo for 3,000 calls. A typical Meta campaign creation uses 4-6 tool calls. See full pricing.
Last modified on April 8, 2026