Skip to content

meta-api-reference

Use when working with Meta Marketing API or Graph API — creating campaigns, ad sets, ads, pulling insights, building custom audiences, handling conversions, or setting up system user authentication. Also use when choosing between Meta API versions or debugging rate limit errors.

ModelSource
sonnetpack: ads
Full Reference

┏━ 🔧 meta-api-reference ━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Use when working with Meta Marketing API or Gr… ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Reference skill for the Meta Graph API and Marketing API. Covers authentication, campaign management, insights, audiences, server-side conversions, and rate limiting. All examples are JavaScript/Node.js.

FactValue
API version (stable)v22.0
API version (latest)v23.0
Base URLhttps://graph.facebook.com/v22.0
Auth methodBearer token (system user token for production)
Rate limit (standard)9,000 pts/hr per app per ad account
Rate limit (dev)60 pts/hr per app per ad account
Key env varsMETA_ACCESS_TOKEN, META_APP_ID, META_APP_SECRET
Breaking change7d_view/28d_view attribution windows removed Jan 2026
Breaking changeASC/AAC via legacy endpoints blocked on v24.0+
I want to…File
Understand API versions and breaking changesreference/versioning.md
Authenticate requests and set up system user tokensreference/auth.md
Use the Graph API node/edge/field pattern and paginationreference/graph-api.md
Create, read, update, and delete campaignsreference/campaigns.md
Create and configure ad sets with targetingreference/ad-sets.md
Create ad creatives, upload images, and create adsreference/ads.md
Pull insights, use date presets, and run async reportsreference/reporting.md
Build custom audiences, add users, and create lookalikesreference/audiences.md
Send server-side conversion events and create custom conversionsreference/conversions.md
Handle rate limits and use batch requestsreference/rate-limits.md

Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.