# 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`.
