Skip to main content
Whop Ads runs paid ads on networks like Meta directly from your Whop account. You fund campaigns from your balance; Whop handles the ad account, review, launch, and billing. Two API calls take you from nothing to a live ad: generate a creative, then create the campaign, ad group, and ad in one request.

​
Resources

ResourceWhat it is
Ad CampaignTop-level container: objective and (optionally) budget.
Ad GroupTargeting, placements, and budget for a set of ads.
AdThe creative unit — copy, assets, destination URL.
AudienceA custom audience to target or exclude in ad groups.

​
One-time setup

  • Scopes: media:generate, media:read, ad_campaign:create, ad_campaign:update, ad_campaign:basic:read, social_account:read.
  • Facebook page: GET /social_accounts must have a "platform": "facebook" entry. If not: POST /social_accounts {"platform": "meta_business", "scopes": ["advertise"], "redirect_url": "..."} → send the user to the returned authorize_url.
  • Ads payment method: connected in the dashboard (balance or card). Only launching needs it — drafts work without.
1

Generate a creative

curl -X POST "https://api.whop.com/api/v1/media/generate" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "image", "prompt": "A running club jogging across a bridge at sunrise, warm light, joyful energy"}'
Billed from your balance (amount_charged; not enough balance → 402 with a deposit_url). Poll GET /media/{id} until status is ready, then use file.id:
{
	"id": "media_Hx7qg4tZc97o",
	"status": "ready",
	"file": { "id": "file_Zsv4DYkrbWE7h" }
}
failed refunds the charge — tweak the prompt and retry. Video: "type": "video" plus optional duration_seconds (5/10/15), resolution (480p–4k), and up to 4 reference_media file IDs (first one seeds the opening frame).
2

Create and launch the ad — one request

POST /ads with an inline ad_group and ad_campaign creates the whole tree in one transaction and launches it:
curl -X POST "https://api.whop.com/api/v1/ads" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Run club launch ad",
    "primary_texts": ["Join 10,000 runners chasing their next PR together."],
    "headlines": ["Find your stride"],
    "call_to_action": "sign_up",
    "url": "https://whop.com/your-store-page",
    "creatives": [{"id": "file_Zsv4DYkrbWE7h"}],
    "social_accounts": [{"id": "sacc_XXXXXXXX"}],
    "ad_group": {
      "title": "US broad",
      "conversion_location": "website",
      "budget_amount": 25,
      "budget_type": "daily",
      "regions": {"include": {"countries": ["US"]}},
      "ad_campaign": {"title": "Run club growth", "platform": "meta", "objective": "sales"}
    }
  }'
Not ready to spend? Add "status": "draft" to ad_campaign, then launch later with PATCH /ad_campaigns/{id} {"status": "active"}.
FieldRule
creativesOne entry with no format is required (the base asset). square / vertical / horizontal are optional crops on top.
urlRequired for website ads. Your whop.com store page works as-is; an external page needs your Whop pixel installed.
BudgetOne level owns it: budget_amount on the ad group (default), or on the campaign with budget_optimization: "ad_campaign" — never both.
TargetingOmit demographics / placements / devices for automatic optimization. regions uses ISO 3166 ("US", "US-CA").
lead_formOnly with an instant-form conversion_location.
To reuse existing containers, pass ad_group_id instead of ad_group, or ad_campaign_id instead of ad_campaign.
3

Monitor

Poll GET /ads/{id}: delivery_status is the live state (a brief in_review for content moderation is normal), and issues[] carries a human-readable message for anything Meta rejected asynchronously.Control delivery with pause / unpause on ads, ad groups, or campaigns. Edit copy or creatives with PATCH /ads/{id} — sending creatives replaces the whole set, so include the base entry.

​
Errors

Every gate is a 400 whose message says what to fix:
Error containsFix
The Whop pixel was not detected on <url>Use your own whop.com store page, or install the pixel on the landing page.
A Facebook page is requiredConnect one via POST /social_accounts (human OAuth step), pass it in social_accounts.
Connect an ads payment method before launchingCreate with ad_campaign.status: "draft", have the user connect a payment method in the dashboard, then PATCH to active.
Include a base creativeAdd a creatives entry with no format.
A destination URL is requiredPass url.
budget_amount is required / can't be setMove the budget to the right level (see field rules above).
402 + deposit_url (media)Send the user to deposit_url to top up, then retry.