Meta Ads Api Field Guide

Meta Ads Field Guide for Claude Code

**Claude Code + Meta Ads without disasters.** A drop-in skill, 3 subagents, and safety hooks that let marketers run Facebook/Instagram campaign automation safely — built on 4,800+ lines of battle-tested Meta Marketing API field notes.

Marketers are using Claude Code to automate Meta Ads work: creating campaigns, pulling insights, scaling budgets, analyzing creatives. But the LLM doesn't know that:

• Changing a budget by more than 20% silently resets your Learning Phase
• The same image hash from another ad account will render as a placeholder (no error)
• CONVERSIONS and LINK_CLICKS objectives are deprecated — new campaigns need OUTCOME_*
• Editing 5+ budgets in an hour locks the ad set for 60 minutes
• Most MCP servers let you create ads with status: "ACTIVE" by default

So Claude makes confident, expensive mistakes.

This repo fixes that. **Copy one folder into your project** and Claude Code suddenly:

• Blocks any API call that would create non-PAUSED ads (via PreToolUse hook)
• Follows a Research → Synthesis → Implementation → Verification workflow with a user-approval gate
• Loads the right field guide page for the current task (rate limits, insights, budgets, creatives, etc.)
• Knows the 23 production pitfalls that Meta's official docs don't warn you about
• Enforces v24-compliant fields so you don't ship deprecated code

**Last verified for**: Marketing API **v24.0** (October 2025) · Planning for **v25.0** (Q1 2026).

---

Who this is for

**Primarily:**

• 🎯 Marketers using Claude Code who want to safely scale their Meta Ads work without learning the API internals
• 🧠 Growth / performance marketers running multiple accounts who need parallel audits, creative analysis, bulk campaign launches
• 🛠️ Marketing ops teams wanting to codify their RSIV workflow as hooks + skills, not prompt discipline

**Also useful for:**

• 👩‍💻 Developers building internal Meta Ads tools