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

> Een Ad Campaign is de container op het hoogste niveau voor betaalde advertenties. Deze bepaalt het doel en de budgetstrategie die de advertentiegroepen en advertenties delen.

Een Ad Campaign is de container op het hoogste niveau voor betaalde advertenties. Deze bepaalt het doel en de budgetstrategie die de [advertentiegroepen](https://docs.whop.com/nl/api-reference/ad-groups/ad-group) en advertenties delen.

Gebruik de Ad Campaigns API om campagnes aan te maken, de campagnes van een account op te vragen, campagne-instellingen op te halen of bij te werken, en de levering van campagnes te pauzeren of te hervatten.

Advertentiefacturering combineert in aanmerking komende uitgaven over alle campagnes van het account. Een mislukte betaling blokkeert de levering met `delivery_status: payment_failed`, terwijl de geconfigureerde active/paused `status` behouden blijft. Herstel de betaalmethode van het account en [probeer de advertentiebetaling opnieuw](https://docs.whop.com/nl/api-reference/accounts/retry-failed-ads-payments.md), één keer voor het account. De nieuwe poging is asynchroon: acceptatie bevestigt de betaling niet. Een geslaagde verrekening heft de blokkade op; actieve campagnes kunnen hervatten als ze verder in aanmerking komen, terwijl gepauzeerde campagnes gepauzeerd blijven. Zie [facturering en nieuwe pogingen](https://docs.whop.com/nl/developer/ads/overview.md#paying-for-ads).

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Ad Campaigns opvragen](https://docs.whop.com/nl/api-reference/ad-campaigns/list-ad-campaigns.md) | GET `/ad_campaigns` |
| [Een Ad Campaign ophalen](https://docs.whop.com/nl/api-reference/ad-campaigns/retrieve-an-ad-campaign.md) | GET `/ad_campaigns/{id}` |
| [Een Ad Campaign aanmaken](https://docs.whop.com/nl/api-reference/ad-campaigns/create-an-ad-campaign.md) | POST `/ad_campaigns` |
| [Een Ad Campaign dupliceren](https://docs.whop.com/nl/api-reference/ad-campaigns/duplicate-an-ad-campaign.md) | POST `/ad_campaigns/{id}/duplicate` |
| [Een Ad Campaign pauzeren](https://docs.whop.com/nl/api-reference/ad-campaigns/pause-an-ad-campaign.md) | POST `/ad_campaigns/{id}/pause` |
| [Een mislukte Ad Campaign-betaling opnieuw proberen](https://docs.whop.com/nl/api-reference/ad-campaigns/retry-a-failed-ad-campaign-payment.md) | POST `/ad_campaigns/{id}/retry_payment` |
| [Een Ad Campaign hervatten](https://docs.whop.com/nl/api-reference/ad-campaigns/unpause-an-ad-campaign.md) | POST `/ad_campaigns/{id}/unpause` |
| [Een Ad Campaign bijwerken](https://docs.whop.com/nl/api-reference/ad-campaigns/update-an-ad-campaign.md) | PATCH `/ad_campaigns/{id}` |
| [Een Ad Campaign verwijderen](https://docs.whop.com/nl/api-reference/ad-campaigns/delete-an-ad-campaign.md) | DELETE `/ad_campaigns/{id}` |

## Attributen

**id** `string` *required*

Unieke identificatie van de advertentiecampagne, met prefix `adcamp_`.

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

Het bedrijf dat deze campagne uitvoert, met de naam en het logo die de advertenties tonen.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Account-ID, met prefix `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL van de logo-afbeelding van het account. `null` wanneer het account er geen heeft ingesteld.
>
> **route** `string` *required*
>
> Publieke route-identificatie van het account, gebruikt in het storefront-pad `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Weergavenaam van het account.

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

USD-waarde toegeschreven aan add-to-cart-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.

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

Door de Whop-pixel toegeschreven add-to-cart-events, last-click.

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

Het budget van de campagne in USD, de valuta waarin het wordt opgeslagen en gefactureerd. `null` wanneer elke advertentiegroep in plaats daarvan een eigen budget instelt.

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

Hetzelfde budget uitgedrukt in `budget_currency` tegen de wisselkoers van vandaag, voor weergave in de advertentierapportagevaluta van het account. `null` wanneer `budget_amount` dat is.

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

De ISO 4217-code waarin `budget_amount_local` is uitgedrukt: de voorkeur `ads_reporting_currency` van het account. `usd`, tenzij het account dit heeft gewijzigd.

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

Welk niveau eigenaar is van het budget: de hele campagne (`ad_campaign`) of elke advertentiegroep afzonderlijk (`ad_group`).

Beschikbare opties: `ad_campaign`, `ad_group`

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

Of `budget_amount` per dag (`daily`) of over de volledige looptijd van de campagne (`lifetime`) wordt besteed.

Beschikbare opties: `daily`, `lifetime`

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

Het soort campagne, vastgelegd bij het aanmaken. `standard` toont afbeeldings- en videoadvertenties; `search` toont tekstadvertenties in zoekresultaten voor de zoekwoorden van de advertentiegroepen.

Beschikbare opties: `standard`, `search`

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

Klikken gedeeld door vertoningen, tussen 0 en 1.

**clicks** `number` *required*

Het aantal klikken.

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

USD-waarde toegeschreven aan complete-registration-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.

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

Door de Whop-pixel toegeschreven complete-registration-events, last-click.

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

USD-waarde toegeschreven aan contact-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.

**contacts** `number` *required*

Door de Whop-pixel toegeschreven contact-events, last-click.

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

Uitgaven gedeeld door toegeschreven add-to-cart-events; null wanneer deze niet het doel zijn en er geen zijn toegeschreven.

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

Uitgaven gedeeld door klikken; 0 wanneer er geen klikken zijn.

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

Uitgaven gedeeld door toegeschreven complete-registration-events; null wanneer deze niet het doel zijn en er geen zijn toegeschreven.

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

Uitgaven gedeeld door toegeschreven contact-events; null wanneer contacten niet het doel zijn en er geen zijn toegeschreven.

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

Uitgaven gedeeld door toegeschreven leads; null wanneer leads geen doel zijn en er geen zijn toegeschreven.

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

Uitgaven per 1.000 vertoningen; 0 wanneer er geen vertoningen zijn.

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

Uitgaven gedeeld door toegeschreven aankopen; null wanneer aankopen geen doel zijn en er geen zijn toegeschreven.

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

Uitgaven gedeeld door door de Whop-pixel toegeschreven resultaten; null wanneer er niets wordt geoptimaliseerd dat aan Whop kan worden toegeschreven.

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

Uitgaven gedeeld door toegeschreven schedule-events; null wanneer afspraken niet het doel zijn en er geen zijn toegeschreven.

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

Uitgaven gedeeld door toegeschreven submit-application-events; null wanneer deze niet het doel zijn en er geen zijn toegeschreven.

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

Uitgaven gedeeld door unieke klikken; null wanneer er geen unieke klikken zijn.

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

Uitgaven gedeeld door toegeschreven view-content-events; null wanneer deze niet het doel zijn en er geen zijn toegeschreven.

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

Wanneer de campagne is aangemaakt, als ISO 8601-tijdstempel.

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

Door de Whop-pixel toegeschreven aangepaste (door de merchant gedefinieerde) conversie-events, last-click, over alle aangepaste eventnamen.

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

Door de Whop-pixel toegeschreven aangepaste conversies, met je eventnaam als sleutel en het last-click-aantal als waarde. Leeg wanneer er geen benoemde aangepaste events zijn toegeschreven. Aangepaste events die zonder naam zijn verstuurd, worden geteld in custom\_conversions maar hier weggelaten, dus deze waarden tellen op tot maximaal custom\_conversions.

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

Conversiewaarde toegeschreven aan elk aangepast event, met de eventnaam als sleutel, zoals bij custom\_event\_counts. Telt de waarde op die aan whop.track is doorgegeven, genormaliseerd naar USD; events die zonder waarde zijn verstuurd, dragen 0 bij.

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

Of de advertenties van de campagne op dit moment worden geleverd, en zo niet, waarom. Contentbeoordeling is in\_review; een campagne die wacht om te starten is processing. Factureringsfouten van het account zetten payment\_failed zonder de geconfigureerde status te wijzigen. Een geslaagde nieuwe betalingspoging heft die blokkade op en berekent de levering opnieuw. Wanneer meerdere statussen tegelijk van toepassing zijn, wordt de status met de hoogste prioriteit geretourneerd.

Beschikbare opties: `payment_failed`, `all_ads_rejected`, `draft`, `paused`, `in_review`, `learning`, `processing`, `revise_content`, `issues`, `scheduled`, `completed`, `active`

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

De kosten per resultaat, in USD, die de adverteerder met deze campagne wil bereiken. Alleen een doelwaarde: het is geen bod, kostenlimiet of biedlimiet en verandert niet hoe de advertenties van de campagne bieden. `null` wanneer er geen doel is ingesteld.

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

Wanneer de campagne stopt met leveren, als ISO 8601-tijdstempel. `null` wanneer deze loopt totdat ze wordt gepauzeerd, of wanneer de advertentiegroepen een eigen planning instellen.

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

Vertoningen gedeeld door bereik.

**impressions** `number` *required*

Het aantal vertoningen.

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

Openstaande problemen die de campagne en de onderliggende advertentiegroepen en advertenties beïnvloeden.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Unieke identificatie van het probleem.
>
> **category** `string` *required*
>
> Het soort probleem: informatie over levering, een waarschuwing of een fout die aandacht vereist.
>
> Beschikbare opties: `information`, `warning`, `error`
>
> **message** `string` *required*
>
> Een beschrijving van wat het probleem is en hoe het kan worden opgelost.
>
> **resource\_id** `string | null` *required*
>
> De ID van de campagne, advertentiegroep of advertentie waaraan het probleem is gekoppeld.
>
> **resource\_type** `string` *required*
>
> Het type resource waaraan het probleem is gekoppeld.
>
> Beschikbare opties: `ad_campaign`, `ad_group`, `ad`
>
> **title** `string` *required*
>
> Een korte titel voor het probleem, bedoeld voor de creator: de regel die bij een afwijzing door de contentbeoordeling wordt genoemd, of een algemeen label.

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

USD-waarde toegeschreven aan lead-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.

**leads** `number` *required*

Door de Whop-pixel toegeschreven leads, last-click.

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

Paginaweergaven op je bestemming door mensen die op de advertentie hebben geklikt, geregistreerd door de Whop-pixel. Op elk advertentieplatform op dezelfde manier geteld.

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

Het doel waarop de campagne optimaliseert. `awareness` verschijnt alleen bij campagnes die zijn aangemaakt voordat deze optie werd uitgefaseerd; die campagnes kunnen niet worden gelanceerd.

Beschikbare opties: `awareness`, `traffic`, `engagement`, `leads`, `sales`

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

USD-waarde van door de pixel toegeschreven aankopen.

**purchases** `number` *required*

Door de Whop-pixel toegeschreven aankopen, last-click.

**reach** `number` *required*

Het aantal unieke personen dat dit heeft gezien.

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

Het Whop-pixel-conversie-event waarvan het toegeschreven aantal de resultaten vertegenwoordigt — het optimalisatiedoel, of het event met het hoogste toegeschreven volume voor campagnes die per advertentiegroep budgetteren. Null wanneer het doel geen door Whop toegeschreven event is.

Beschikbare opties: `purchase`, `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `custom`, `messaging_conversation`

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

De door de merchant gedefinieerde eventnaam wanneer result\_event custom is; null voor de standaard-events.

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

Het door de Whop-pixel toegeschreven aantal achter result\_event. Wanneer de advertentiegroepen van een campagne op verschillende doelen optimaliseren, is er geen enkele result\_event (die is dan null), en is dit in plaats daarvan de som van de eigen toegeschreven resultaten van elke advertentiegroep. Null wanneer er niets wordt geoptimaliseerd dat aan Whop kan worden toegeschreven.

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

Aankoopwaarde gedeeld door uitgaven, beide in USD (een valuta-neutrale verhouding); 0 wanneer er geen uitgaven zijn.

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

USD-waarde toegeschreven aan schedule-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.

**schedules** `number` *required*

Door de Whop-pixel toegeschreven schedule-events, last-click.

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

Gereguleerde categorieën waaronder de campagne is aangemeld. Advertenties in deze categorieën zijn onderworpen aan extra targetingbeperkingen. Leeg wanneer er geen van toepassing zijn.

Beschikbare opties: `housing`, `employment`, `financial_products`, `politics`

**spend** `number` *required*

Het in rekening gebrachte bedrag, in spend\_currency.

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

De ISO 4217-valutacode van alle monetaire statistieken.

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

Wanneer de campagne begint met leveren, als ISO 8601-tijdstempel. `null` wanneer deze start zodra ze wordt gelanceerd, of wanneer de advertentiegroepen een eigen planning instellen.

**status** `string` *required*

De geconfigureerde levenscyclusstatus van de advertentiecampagne. Bij factureringsfouten blijft active of paused hier behouden en wordt delivery\_status ingesteld op payment\_failed.

Beschikbare opties: `active`, `paused`, `inactive`, `payment_failed`, `draft`, `duplicating`

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

USD-waarde toegeschreven aan submit-application-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.

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

Door de Whop-pixel toegeschreven submit-application-events, last-click.

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

De gewenste kosten per resultaat voor `target_result_event`, in USD. `null` wanneer er geen is ingesteld.

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

Het event waarvoor `target_cost_per_result` wordt geprijsd, zoals `purchase` of `lead`. `null` wanneer de campagne geen enkel doel heeft.

**title** `string` *required*

Weergavenaam van de advertentiecampagne.

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

Unieke klikken gedeeld door vertoningen, tussen 0 en 1.

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

Personen die hebben geklikt, gerapporteerd door de Whop-pixel, één keer per persoon geteld.

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

Wanneer de campagne voor het laatst is bijgewerkt, als ISO 8601-tijdstempel.

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

USD-waarde toegeschreven aan view-content-events. Telt de waarde op die met elk event is meegestuurd, genormaliseerd naar USD; events zonder waarde dragen 0 bij.

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

Door de Whop-pixel toegeschreven view-content-events, 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

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