ads
Simple Ads: campaign wizard, targeting, estimates, publish, budgets, insights, attribution.
Simple Ads: campaign wizard, targeting, estimates, publish, budgets, insights, attribution.
| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | /v1/ad-campaigns | ad_campaigns_list: List ad campaigns | ads:read | - |
| POST | /v1/ad-campaigns | ad_campaigns_create: Create a campaign draft with the Simple Ads wizard | ads:write | - |
| DELETE | /v1/ad-campaigns/{campaign_id} | ad_campaigns_delete: Delete a draft (or mark an archived campaign deleted at Meta) | ads:write | - |
| GET | /v1/ad-campaigns/{campaign_id} | ad_campaigns_get: Get a campaign with ad sets, ads, review feedback and an insights snapshot | ads:read | - |
| PATCH | /v1/ad-campaigns/{campaign_id} | ad_campaigns_update: Edit a draft, or schedule/audience of a live campaign | ads:write | - |
| GET | /v1/ad-campaigns/{campaign_id}/ad-sets | ad_campaigns_list_ad_sets: List the ad sets of a campaign | ads:read | - |
| POST | /v1/ad-campaigns/{campaign_id}/archive | ad_campaigns_archive: Archive a campaign | ads:write | - |
| POST | /v1/ad-campaigns/{campaign_id}/budget | ad_campaigns_change_budget: Change budget or end time (rate-limit aware) | ads:spend | - |
| POST | /v1/ad-campaigns/{campaign_id}/duplicate | ad_campaigns_duplicate: Duplicate as a draft | ads:write | - |
| POST | /v1/ad-campaigns/{campaign_id}/pause | ad_campaigns_pause: Pause a campaign | ads:spend | - |
| GET | /v1/ad-campaigns/{campaign_id}/preview | ad_campaigns_preview: Ad previews per placement | ads:read | - |
| POST | /v1/ad-campaigns/{campaign_id}/publish | ad_campaigns_publish: Publish: create the Meta objects paused, then activate (spend confirmation required) | ads:spend | - |
| POST | /v1/ad-campaigns/{campaign_id}/resume | ad_campaigns_resume: Resume a campaign | ads:spend | - |
| POST | /v1/ad-campaigns/{campaign_id}/validate | ad_campaigns_validate: Dry-run the campaign (local checks plus Meta validate_only) | ads:read | - |
| GET | /v1/ad-changes | ad_changes_list: Changes waiting at Facebook, across all ads | ads:read | - |
| GET | /v1/ad-creatives | ad_creatives_list: Creative library | ads:read | - |
| POST | /v1/ad-creatives | ad_creatives_create: Create a creative from the media library and copy | ads:write | - |
| POST | /v1/ad-creatives:generate-copy | ad_creatives_generate_copy: AI headline and text variants (English, Hindi, Hinglish) | ai:read | - |
| GET | /v1/ad-sets/{ad_set_id} | ad_sets_get: Get one ad set | ads:read | - |
| PATCH | /v1/ad-sets/{ad_set_id} | ad_sets_update: Update targeting or budget on one ad set | ads:spend | - |
| GET | /v1/ad-sets/{ad_set_id}/ads | ad_sets_list_ads: List the ads of an ad set | ads:read | - |
| GET | /v1/ads/{ad_id} | ads_get: Get an ad with effective status, review feedback and issues | ads:read | - |
| PATCH | /v1/ads/{ad_id}/creative | ads_replace_creative: Replace the creative (new creative id; the ad goes back to review) | ads:write | - |
| POST | /v1/ads/{ad_id}/pause | ads_pause: Pause one ad | ads:spend | - |
| POST | /v1/ads/{ad_id}/resume | ads_resume: Resume one ad | ads:spend | - |
| GET | /v1/ads/attribution | ads_attribution: Ad to chat to sale funnel per campaign | ads:read | - |
| POST | /v1/ads/boost | ads_boost: Boost a published post or Reel in 3 taps (creates a draft campaign) | ads:write | - |
| POST | /v1/ads/estimates | ads_estimates: Audience estimate (a range, never a promise) | ads:read | - |
| GET | /v1/ads/insights | ads_insights: Insights: stored daily rows (default) or live from Meta, joined with our conversations, sales and revenue | ads:read | - |
| POST | /v1/ads/insights/reports | ads_insights_reports_create: Start an async insights report (large ranges) | ads:read | - |
| GET | /v1/ads/insights/reports/{report_id} | ads_insights_reports_get: Poll or fetch an insights report | ads:read | - |
| GET | /v1/ads/targeting/presets | ads_targeting_presets: Plain-language audience presets | ads:read | - |
| GET | /v1/ads/targeting/search | ads_targeting_search: Targeting search proxy (cached 24 h, interests revalidated) | ads:read | - |
| POST | /v1/ads/targeting/validate | ads_targeting_validate: Validate targeting including special-category constraints | ads:read | - |
Request and response schemas: the interactive reference at https://api.wapitick.com/docs, or docs/api/openapi.json.