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

# Ad Campaigns API

> En Ad Campaign er containeren på øverste niveau for betalte annoncer. Den angiver det mål og den budgetstrategi, som dens annoncegrupper og annoncer deler.

En Ad Campaign er containeren på øverste niveau for betalte annoncer. Den angiver det mål og den budgetstrategi, som dens [annoncegrupper](https://docs.whop.com/da/api-reference/ad-groups/ad-group) og annoncer deler.

Brug Ad Campaigns API'et til at oprette kampagner, vise kampagner for en konto, hente eller opdatere kampagneindstillinger og sætte kampagnelevering på pause eller genoptage den.

Annoncefakturering samler berettiget forbrug på tværs af kontoens kampagner. En mislykket betaling blokerer levering med `delivery_status: payment_failed`, mens den konfigurerede active/paused-`status` bevares. Ret kontoens betalingsmetode, og [prøv annoncebetalingen igen](https://docs.whop.com/da/api-reference/accounts/retry-failed-ads-payments.md) én gang for kontoen. Det nye forsøg er asynkront: accept bekræfter ikke betalingen. En vellykket afregning fjerner blokeringen; aktive kampagner kan genoptages, hvis de ellers er berettigede, mens pausede kampagner forbliver pausede. Se [fakturering og nye forsøg](https://docs.whop.com/da/developer/ads/overview.md#paying-for-ads).

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis Ad Campaigns](https://docs.whop.com/da/api-reference/ad-campaigns/list-ad-campaigns.md) | GET `/ad_campaigns` |
| [Hent en Ad Campaign](https://docs.whop.com/da/api-reference/ad-campaigns/retrieve-an-ad-campaign.md) | GET `/ad_campaigns/{id}` |
| [Opret en Ad Campaign](https://docs.whop.com/da/api-reference/ad-campaigns/create-an-ad-campaign.md) | POST `/ad_campaigns` |
| [Duplikér en Ad Campaign](https://docs.whop.com/da/api-reference/ad-campaigns/duplicate-an-ad-campaign.md) | POST `/ad_campaigns/{id}/duplicate` |
| [Sæt en Ad Campaign på pause](https://docs.whop.com/da/api-reference/ad-campaigns/pause-an-ad-campaign.md) | POST `/ad_campaigns/{id}/pause` |
| [Prøv en mislykket Ad Campaign-betaling igen](https://docs.whop.com/da/api-reference/ad-campaigns/retry-a-failed-ad-campaign-payment.md) | POST `/ad_campaigns/{id}/retry_payment` |
| [Genoptag en Ad Campaign](https://docs.whop.com/da/api-reference/ad-campaigns/unpause-an-ad-campaign.md) | POST `/ad_campaigns/{id}/unpause` |
| [Opdater en Ad Campaign](https://docs.whop.com/da/api-reference/ad-campaigns/update-an-ad-campaign.md) | PATCH `/ad_campaigns/{id}` |
| [Slet en Ad Campaign](https://docs.whop.com/da/api-reference/ad-campaigns/delete-an-ad-campaign.md) | DELETE `/ad_campaigns/{id}` |

## Attributter

**id** `string` *required*

Unik identifikator for annoncekampagnen med præfikset `adcamp_`.

**account** `object | null` *required*

Virksomheden, der kører denne kampagne, med det navn og logo, som dens annoncer viser.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Konto-ID med præfikset `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL til kontoens logobillede. `null`, når kontoen ikke har angivet et.
>
> **route** `string` *required*
>
> Kontoens offentlige rute-identifikator, der bruges i butiksstien `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Kontoens visningsnavn.

**added\_to\_cart\_value** `number` *required*

USD-værdi tilskrevet add-to-cart-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**added\_to\_carts** `number` *required*

Whop-pixel-tilskrevne add-to-cart-hændelser, last-click.

**budget\_amount** `number | null` *required*

Kampagnens budget i USD, som er den valuta, det gemmes og faktureres i. `null`, når hver annoncegruppe i stedet angiver sit eget budget.

**budget\_amount\_local** `number | null` *required*

Det samme budget angivet i `budget_currency` til dagens vekselkurs, til visning i kontoens rapporteringsvaluta for annoncer. `null`, når `budget_amount` er det.

**budget\_currency** `string` *required*

ISO 4217-koden, som `budget_amount_local` er i: kontoens `ads_reporting_currency`-præference. `usd`, medmindre kontoen har ændret den.

**budget\_optimization** `string | null` *required*

Hvilket niveau der ejer budgettet: hele kampagnen (`ad_campaign`) eller hver annoncegruppe individuelt (`ad_group`).

Tilgængelige muligheder: `ad_campaign`, `ad_group`

**budget\_type** `string | null` *required*

Om `budget_amount` bruges pr. dag (`daily`) eller over kampagnens samlede løbetid (`lifetime`).

Tilgængelige muligheder: `daily`, `lifetime`

**campaign\_type** `string` *required*

Kampagnetypen, fastlagt ved oprettelsen. `standard` kører billed- og videoannoncer; `search` viser tekstannoncer i søgeresultater for annoncegruppernes søgeord.

Tilgængelige muligheder: `standard`, `search`

**click\_through\_rate** `number` *required*

Klik divideret med visninger, mellem 0 og 1.

**clicks** `number` *required*

Antallet af klik.

**completed\_registration\_value** `number` *required*

USD-værdi tilskrevet complete-registration-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**completed\_registrations** `number` *required*

Whop-pixel-tilskrevne complete-registration-hændelser, last-click.

**contact\_value** `number` *required*

USD-værdi tilskrevet contact-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**contacts** `number` *required*

Whop-pixel-tilskrevne contact-hændelser, last-click.

**cost\_per\_added\_to\_cart** `number | null` *required*

Forbrug divideret med tilskrevne add-to-cart-hændelser; null, når de ikke er målet, og ingen er tilskrevet.

**cost\_per\_click** `number` *required*

Forbrug divideret med klik; 0, når der ikke er nogen klik.

**cost\_per\_completed\_registration** `number | null` *required*

Forbrug divideret med tilskrevne complete-registration-hændelser; null, når de ikke er målet, og ingen er tilskrevet.

**cost\_per\_contact** `number | null` *required*

Forbrug divideret med tilskrevne contact-hændelser; null, når kontakter ikke er målet, og ingen er tilskrevet.

**cost\_per\_lead** `number | null` *required*

Forbrug divideret med tilskrevne leads; null, når leads ikke er et mål, og ingen er tilskrevet.

**cost\_per\_mille** `number` *required*

Forbrug pr. 1.000 visninger; 0, når der ikke er nogen visninger.

**cost\_per\_purchase** `number | null` *required*

Forbrug divideret med tilskrevne køb; null, når køb ikke er et mål, og ingen er tilskrevet.

**cost\_per\_result** `number | null` *required*

Forbrug divideret med Whop-pixel-tilskrevne resultater; null, når der ikke optimeres efter noget, Whop kan tilskrive.

**cost\_per\_schedule** `number | null` *required*

Forbrug divideret med tilskrevne schedule-hændelser; null, når bookinger ikke er målet, og ingen er tilskrevet.

**cost\_per\_submitted\_application** `number | null` *required*

Forbrug divideret med tilskrevne submit-application-hændelser; null, når de ikke er målet, og ingen er tilskrevet.

**cost\_per\_unique\_click** `number | null` *required*

Forbrug divideret med unikke klik; null, når der ikke er nogen unikke klik.

**cost\_per\_viewed\_content** `number | null` *required*

Forbrug divideret med tilskrevne view-content-hændelser; null, når de ikke er målet, og ingen er tilskrevet.

**created\_at** `string` *required*

Hvornår kampagnen blev oprettet, som et ISO 8601-tidsstempel.

**custom\_conversions** `number` *required*

Whop-pixel-tilskrevne brugerdefinerede (forhandlerdefinerede) konverteringshændelser, last-click, på tværs af alle brugerdefinerede hændelsesnavne.

**custom\_event\_counts** `object` *required*

Whop-pixel-tilskrevne brugerdefinerede konverteringer med dit hændelsesnavn som nøgle og dets last-click-antal som værdi. Tom, når ingen navngivne brugerdefinerede hændelser er tilskrevet. Brugerdefinerede hændelser, der udløses uden et navn, tælles med i custom\_conversions, men udelades her, så disse værdier summerer til højst custom\_conversions.

**custom\_event\_values** `object` *required*

Konverteringsværdi tilskrevet hver brugerdefineret hændelse med hændelsesnavnet som nøgle ligesom custom\_event\_counts. Summerer den værdi, der sendes til whop.track, normaliseret til USD; hændelser, der udløses uden en værdi, bidrager med 0.

**delivery\_status** `string` *required*

Om kampagnens annoncer leveres lige nu, og hvis ikke, hvorfor. Indholdsgennemgang er in\_review; en kampagne, der venter på at starte, er processing. Fejl i kontoens fakturering sætter payment\_failed uden at ændre den konfigurerede status. Et vellykket nyt betalingsforsøg fjerner den blokering og genberegner leveringen. Når flere tilstande gælder på én gang, returneres den med højest prioritet.

Tilgængelige muligheder: `payment_failed`, `all_ads_rejected`, `draft`, `paused`, `in_review`, `learning`, `processing`, `revise_content`, `issues`, `scheduled`, `completed`, `active`

**desired\_cost\_per\_result** `number | null`

Den pris pr. resultat i USD, som annoncøren ønsker, at denne kampagne opnår. Kun et mål: det er ikke et bud, et omkostningsloft eller et budloft og ændrer ikke, hvordan kampagnens annoncer byder. `null`, når der ikke er angivet et mål.

**ends\_at** `string | null` *required*

Hvornår kampagnen stopper med at levere, som et ISO 8601-tidsstempel. `null`, når den kører, indtil den sættes på pause, eller når dens annoncegrupper angiver deres egen tidsplan.

**frequency** `number | null` *required*

Visninger divideret med rækkevidde.

**impressions** `number` *required*

Antallet af visninger.

**issues** `object[]` *required*

Åbne problemer, der påvirker kampagnen og dens underliggende annoncegrupper og annoncer.

> [accordion] Egenskaber
>
> **id** `string` *required*
>
> Unik identifikator for problemet.
>
> **category** `string` *required*
>
> Problemets type: information om levering, en advarsel eller en fejl, der kræver opmærksomhed.
>
> Tilgængelige muligheder: `information`, `warning`, `error`
>
> **message** `string` *required*
>
> En beskrivelse af, hvad problemet er, og hvordan det kan løses.
>
> **resource\_id** `string | null` *required*
>
> ID'et for den kampagne, annoncegruppe eller annonce, som problemet er knyttet til.
>
> **resource\_type** `string` *required*
>
> Typen af den ressource, som problemet er knyttet til.
>
> Tilgængelige muligheder: `ad_campaign`, `ad_group`, `ad`
>
> **title** `string` *required*
>
> En kort titel til skaberen for problemet: den regel, en afvisning ved indholdsgennemgang nævner, eller en generisk etiket.

**lead\_value** `number` *required*

USD-værdi tilskrevet lead-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**leads** `number` *required*

Whop-pixel-tilskrevne leads, last-click.

**link\_clicks** `number` *required*

Sidevisninger på din destination fra personer, der klikkede på annoncen, registreret af Whop-pixelen. Tælles på samme måde på alle annonceplatforme.

**objective** `string | null` *required*

Det mål, kampagnen optimerer mod. `awareness` vises kun på kampagner, der er oprettet, før det blev udfaset; disse kampagner kan ikke lanceres.

Tilgængelige muligheder: `awareness`, `traffic`, `engagement`, `leads`, `sales`

**purchase\_value** `number` *required*

USD-værdi af pixel-tilskrevne køb.

**purchases** `number` *required*

Whop-pixel-tilskrevne køb, last-click.

**reach** `number` *required*

Antallet af unikke personer, der så dette.

**result\_event** `string | null` *required*

Den Whop-pixel-konverteringshændelse, hvis tilskrevne antal repræsenterer resultater — optimeringsmålet eller den tilskrevne hændelse med størst volumen for kampagner, der budgetterer pr. annoncegruppe. Null, når målet ikke er en Whop-tilskrevet hændelse.

Tilgængelige muligheder: `purchase`, `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `custom`, `messaging_conversation`

**result\_event\_name** `string | null` *required*

Det forhandlerdefinerede hændelsesnavn, når result\_event er custom; null for standardhændelserne.

**results** `number | null` *required*

Det Whop-pixel-tilskrevne antal bag result\_event. Når en kampagnes annoncegrupper optimerer efter forskellige mål, er der ingen enkelt result\_event (den er null), og dette er i stedet summen af hver annoncegruppes egne tilskrevne resultater. Null, når der ikke optimeres efter noget, Whop kan tilskrive.

**return\_on\_ad\_spend** `number` *required*

Købsværdi divideret med forbrug, begge i USD (et valutaneutralt forhold); 0, når der ikke er noget forbrug.

**schedule\_value** `number` *required*

USD-værdi tilskrevet schedule-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**schedules** `number` *required*

Whop-pixel-tilskrevne schedule-hændelser, last-click.

**special\_ad\_categories** `string[]` *required*

Regulerede kategorier, som kampagnen er erklæret under. Annoncer i disse kategorier er underlagt ekstra målretningsbegrænsninger. Tom, når ingen gælder.

Tilgængelige muligheder: `housing`, `employment`, `financial_products`, `politics`

**spend** `number` *required*

Det opkrævede beløb i spend\_currency.

**spend\_currency** `string | null` *required*

ISO 4217-valutakoden for alle monetære målinger.

**starts\_at** `string | null` *required*

Hvornår kampagnen begynder at levere, som et ISO 8601-tidsstempel. `null`, når den starter, så snart den lanceres, eller når dens annoncegrupper angiver deres egen tidsplan.

**status** `string` *required*

Annoncekampagnens konfigurerede livscyklusstatus. Faktureringsfejl bevarer active eller paused her og sætter delivery\_status til payment\_failed.

Tilgængelige muligheder: `active`, `paused`, `inactive`, `payment_failed`, `draft`, `duplicating`

**submitted\_application\_value** `number` *required*

USD-værdi tilskrevet submit-application-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**submitted\_applications** `number` *required*

Whop-pixel-tilskrevne submit-application-hændelser, last-click.

**target\_cost\_per\_result** `number | null` *required*

Den ønskede pris pr. resultat for `target_result_event` i USD. `null`, når ingen er angivet.

**target\_result\_event** `string | null` *required*

Den hændelse, som `target_cost_per_result` er prissat pr., såsom `purchase` eller `lead`. `null`, når kampagnen ikke har et enkelt mål.

**title** `string` *required*

Annoncekampagnens visningsnavn.

**unique\_click\_through\_rate** `number | null` *required*

Unikke klik divideret med visninger, mellem 0 og 1.

**unique\_clicks** `number` *required*

Personer, der klikkede, rapporteret af Whop-pixelen, talt én gang pr. person.

**updated\_at** `string` *required*

Hvornår kampagnen sidst blev opdateret, som et ISO 8601-tidsstempel.

**viewed\_content\_value** `number` *required*

USD-værdi tilskrevet view-content-hændelser. Summerer den værdi, der sendes med hver hændelse, normaliseret til USD; hændelser uden en værdi bidrager med 0.

**viewed\_contents** `number` *required*

Whop-pixel-tilskrevne view-content-hændelser, last-click.

```json AdCampaign theme={null}
{
	"id": "adcamp_xxxxxxxxxx",
	"account": {
		"id": "biz_xxxxxxxxxxxxx",
		"title": "Acme Studio",
		"route": "acme-studio",
		"logo_url": "https://img.whop.com/acme-studio-logo.png"
	},
	"added_to_cart_value": 2100,
	"added_to_carts": 42,
	"budget_amount": 250,
	"budget_amount_local": 250,
	"budget_currency": "usd",
	"budget_optimization": "ad_campaign",
	"budget_type": "daily",
	"campaign_type": "standard",
	"click_through_rate": 0.032,
	"clicks": 1200,
	"completed_registration_value": 0,
	"completed_registrations": 28,
	"contact_value": 0,
	"contacts": 18,
	"cost_per_added_to_cart": 17.86,
	"cost_per_click": 0.63,
	"cost_per_completed_registration": 26.79,
	"cost_per_contact": 41.67,
	"cost_per_lead": 30,
	"cost_per_mille": 20,
	"cost_per_purchase": 50,
	"cost_per_result": 50,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.74,
	"cost_per_viewed_content": 1.25,
	"created_at": "2026-06-01T12:00:00Z",
	"custom_conversions": 10,
	"custom_event_counts": {
		"QualifiedCall": 7,
		"BookedDemo": 3
	},
	"custom_event_values": {
		"QualifiedCall": 3500,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"ends_at": null,
	"frequency": 2.1,
	"impressions": 37500,
	"issues": [
		{
			"id": "adiss_xxxxxxxxxxx",
			"category": "error",
			"title": "Ad issue",
			"message": "The ad's creative violates the ad network's policies. Edit the creative and resubmit for review.",
			"resource_id": "adcamp_xxxxxxxxxx",
			"resource_type": "ad_campaign"
		}
	],
	"lead_value": 1250,
	"leads": 25,
	"link_clicks": 960,
	"objective": "sales",
	"purchase_value": 12600,
	"purchases": 15,
	"reach": 17800,
	"result_event": "purchase",
	"result_event_name": null,
	"results": 15,
	"return_on_ad_spend": 16.8,
	"schedule_value": 0,
	"schedules": 0,
	"special_ad_categories": [],
	"spend": 750,
	"spend_currency": "usd",
	"starts_at": null,
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"target_cost_per_result": 12.5,
	"target_result_event": "purchase",
	"title": "Pickaxe Pro launch",
	"unique_click_through_rate": 0.027,
	"unique_clicks": 1010,
	"updated_at": "2026-06-02T12:00:00Z",
	"viewed_content_value": 0,
	"viewed_contents": 600
}
```


## Related topics

- [Annoncekampagner](https://docs.whop.com/da/api-reference/legacy/ad-campaigns/ad-campaign.md)
- [Delete an Ad Campaign](https://docs.whop.com/da/api-reference/ad-campaigns/delete-an-ad-campaign.md)
- [Create an Ad Campaign](https://docs.whop.com/da/api-reference/ad-campaigns/create-an-ad-campaign.md)
