> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Ads API – oversigt

> Lancér Whop Ads via API'et ved at generere en kreativ og derefter oprette kampagnen, annoncegruppen og annoncen i én anmodning.

Whop Ads kører betalte annoncer på eksterne annoncenetværk direkte fra din Whop-konto. Annonceforbrug faktureres til kontoens konfigurerede kort eller saldo på tværs af dens kampagner. Whop håndterer annoncekontoen, gennemgang, lancering og fakturering.

To API-kald fører dig fra ingenting til en live annonce: generér en kreativ, og opret derefter kampagnen, annoncegruppen og annoncen i én anmodning.

## Ressourcer

| Ressource | Formål |
| - | - |
| [Ad Campaign](https://docs.whop.com/da/api-reference/ad-campaigns/ad-campaign) | Container på øverste niveau: mål og (eventuelt) budget. |
| [Ad Group](https://docs.whop.com/da/api-reference/ad-groups/ad-group) | Målretning og budget for et sæt annoncer. |
| [Ad](https://docs.whop.com/da/api-reference/ads/ad) | Den kreative enhed — tekst, assets, destinations-URL. |
| [Audience](https://docs.whop.com/da/api-reference/audiences/audience) | En brugerdefineret audience, der skal målrettes eller udelukkes i annoncegrupper. |

## Fakturering og genopretning af betalinger

Forbrug opkræves på kontoniveau på tværs af kampagner. En mislykket betaling blokerer levering med `delivery_status: "payment_failed"`, mens hver kampagnes konfigurerede active/paused-`status` bevares. Ret kontoens betalingsmetode, og kald derefter [Retry Failed Ads Payments](https://docs.whop.com/da/api-reference/accounts/retry-failed-ads-payments.md) én gang for kontoen. Svaret sætter et forsøg i kø i baggrunden; det bekræfter ikke betalingen. Efter afregning kan aktive kampagner genoptages, og pausede kampagner forbliver pausede, med forbehold for andre leveringskrav.

Se [Betaling for annoncer](https://docs.whop.com/da/developer/ads/overview.md#paying-for-ads) for dashboard-forløbet, et anmodningseksempel, adfærd ved duplikerede anmodninger og håndtering af ældre kampagner.

## Engangsopsætning

* **Scopes**: `media:generate`, `media:read`, `ad_campaign:create`, `ad_campaign:update`, `ad_campaign:basic:read`.
* **Betalingsmetode til annoncer**: tilknyttes i dashboardet (saldo eller kort). Kun lancering kræver den — kladder virker uden.

**1. Generér en kreativ**

```bash theme={null}
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"}'
```

Faktureres fra din saldo (`amount_charged`; utilstrækkelig saldo → `402` med en `deposit_url`). Poll [`GET /media/{id}`](https://docs.whop.com/da/api-reference/media/retrieve-media-asset), indtil `status` er `ready`, og brug derefter `file.id`:

```json theme={null}
{
	"id": "media_Hx7qg4tZc97o",
	"status": "ready",
	"file": { "id": "file_Zsv4DYkrbWE7h" }
}
```

`failed` refunderer beløbet — justér prompten, og prøv igen. Video: `"type": "video"` plus valgfri `duration_seconds` (5/10/15), `resolution` (`480p`–`4k`) og op til 4 `reference_media`-fil-ID'er (den første danner grundlag for åbningsbilledet).

**2. Opret og lancér annoncen — én anmodning**

[`POST /ads`](https://docs.whop.com/da/api-reference/ads/create-an-ad) med en inline `ad_group` og `ad_campaign` opretter hele træet i én transaktion og lancerer det:

```bash theme={null}
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"}],
    "ad_group": {
      "title": "US broad",
      "budget_amount": 25,
      "budget_type": "daily",
      "regions": {"include": {"countries": ["US"]}},
      "ad_campaign": {"title": "Run club growth", "objective": "sales"}
    }
  }'
```

Ikke klar til at bruge penge? Tilføj `"status": "draft"` til `ad_campaign`, og lancér senere med [`PATCH /ad_campaigns/{id}`](https://docs.whop.com/da/api-reference/ad-campaigns/update-an-ad-campaign) `{"status": "active"}`.

| Felt | Regel |
| - | - |
| `creatives` | Én post uden `format` er påkrævet (basis-asset'et). `square` / `vertical` / `horizontal` er valgfrie beskæringer ovenpå. |
| `url` | Påkrævet for website-annoncer. Din whop.com-butiksside virker, som den er; en ekstern side kræver, at din [Whop-pixel](https://docs.whop.com/da/developer/ads/pixel.md) er installeret. |
| Budget | Ét niveau ejer det: `budget_amount` på annoncegruppen (standard) eller på kampagnen med `budget_optimization: "ad_campaign"` — aldrig begge. |
| Valuta | `budget_amount` er i USD, som budgetter gemmes og faktureres i. For i stedet at angive et budget i kontoens `ads_reporting_currency` skal du sende `budget_amount_local`; Whop omregner det til den aktuelle kurs og gemmer resultatet i USD. Send det ene eller det andet, aldrig begge. Svar indeholder `budget_amount`, `budget_amount_local` og `budget_currency`. |
| Målretning | Udelad `demographics` / `devices` for automatisk optimering. `regions` bruger ISO 3166 (`"US"`, `"US-CA"`). |

For at genbruge eksisterende containere skal du sende `ad_group_id` i stedet for `ad_group` eller `ad_campaign_id` i stedet for `ad_campaign`.

**3. Overvåg**

Poll [`GET /ads/{id}`](https://docs.whop.com/da/api-reference/ads/retrieve-an-ad): `delivery_status` er den aktuelle tilstand (en kort `in_review` til indholdsmoderering er normal), og `issues[]` indeholder en menneskeligt læsbar `message` for alt, hvad annoncenetværket har afvist asynkront.

Styr levering med [`pause`](https://docs.whop.com/da/api-reference/ads/pause-an-ad) / [`unpause`](https://docs.whop.com/da/api-reference/ads/unpause-an-ad) på annoncer, annoncegrupper eller kampagner. Redigér tekst eller kreativer med [`PATCH /ads/{id}`](https://docs.whop.com/da/api-reference/ads/update-an-ad) — når du sender `creatives`, erstattes hele sættet, så husk at inkludere basisposten.

## Fejl

Hver kontrol er en `400`, hvis besked fortæller, hvad der skal rettes:

| Fejlen indeholder | Løsning |
| - | - |
| `The Whop pixel was not detected on <url>` | Brug din egen whop.com-butiksside, eller [installér pixelen](https://docs.whop.com/da/developer/ads/pixel.md) på landingssiden. |
| `Connect an ads payment method before launching` | Opret med `ad_campaign.status: "draft"`, lad brugeren tilknytte en betalingsmetode i dashboardet, og `PATCH` derefter til `active`. |
| `Include a base creative` | Tilføj en `creatives`-post uden `format`. |
| `A destination URL is required` | Send `url`. |
| `budget_amount is required` / `can't be set` | Flyt budgettet til det rigtige niveau (se feltreglerne ovenfor). |
| `Provide either budget_amount (USD) or budget_amount_local` | De to felter angav forskellige budgetter; send ét. En gentaget `GET`-body, hvis lokale beløb gengiver det gemte, er i orden. |
| `503` `Exchange rate for <currency> is unavailable` | Whop har ikke en aktuel kurs for kontoens rapporteringsvaluta lige nu; prøv igen om et par minutter. |
| `402` + `deposit_url` (media) | Send brugeren til `deposit_url` for at fylde op, og prøv derefter igen. |


## Related topics

- [Whop API-oversigt](https://docs.whop.com/da/api-reference/overview.md)
- [Ads API](https://docs.whop.com/da/api-reference/ads/ad.md)
- [List Ads](https://docs.whop.com/da/api-reference/ads/list-ads.md)
