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

> Een Ad is de afzonderlijke creatieve eenheid die door een advertentiegroep wordt geleverd. Deze bevat de tekst, creatieve assets en bestemmings-URL voor één advertentie.

Een Ad is de afzonderlijke creatieve eenheid die door een [advertentiegroep](https://docs.whop.com/nl/api-reference/ad-groups/ad-group) wordt geleverd. Deze bevat de tekst, creatieve assets en bestemmings-URL voor één advertentie.

Gebruik de Ads API om de advertenties van een account op te vragen, advertenties binnen advertentiegroepen aan te maken, creatieve details op te halen of bij te werken, advertenties te verwijderen die moeten stoppen en de levering te pauzeren of te hervatten.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Ads opvragen](https://docs.whop.com/nl/api-reference/ads/list-ads.md) | GET `/ads` |
| [Een Ad ophalen](https://docs.whop.com/nl/api-reference/ads/retrieve-an-ad.md) | GET `/ads/{id}` |
| [Een Ad aanmaken](https://docs.whop.com/nl/api-reference/ads/create-an-ad.md) | POST `/ads` |
| [Een Ad dupliceren](https://docs.whop.com/nl/api-reference/ads/duplicate-an-ad.md) | POST `/ads/{id}/duplicate` |
| [Een Ad pauzeren](https://docs.whop.com/nl/api-reference/ads/pause-an-ad.md) | POST `/ads/{id}/pause` |
| [Een Ad hervatten](https://docs.whop.com/nl/api-reference/ads/unpause-an-ad.md) | POST `/ads/{id}/unpause` |
| [Een Ad bijwerken](https://docs.whop.com/nl/api-reference/ads/update-an-ad.md) | PATCH `/ads/{id}` |
| [Een Ad verwijderen](https://docs.whop.com/nl/api-reference/ads/delete-an-ad.md) | DELETE `/ads/{id}` |

## Attributen

**id** `string` *required*

Unieke identificatie van de advertentie, met prefix `ad_`.

**ad\_campaign** `object` *required*

De advertentiecampagne waartoe deze advertentie behoort.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De id van de entiteit waarnaar wordt verwezen.

**ad\_group** `object` *required*

De advertentiegroep waartoe deze advertentie behoort.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De id van de entiteit waarnaar wordt verwezen.

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

**call\_to\_action** `string | null` *required*

De call-to-action-knop die op de advertentie wordt getoond.

Beschikbare opties: `learn_more`, `shop_now`, `sign_up`, `subscribe`, `get_started`, `book_now`, `apply_now`, `contact_us`, `download`, `order_now`, `buy_now`, `get_quote`, `message_page`, `whatsapp_message`, `instagram_message`, `call_now`, `get_directions`, `send_updates`, `get_offer`, `watch_more`, `listen_now`, `play_game`, `open_link`, `no_button`, `get_offer_view`, `get_event_tickets`, `see_menu`, `request_time`, `event_rsvp`, `see_details`, `view_instagram_profile`, `donate_now`, `see_more`, `visit_site`

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

**content\_review** `object` *required*

De contentbeoordeling van deze advertentie door Whop: of deze is afgerond, voor welke advertentienetwerken de advertentie wordt aanbevolen en welke contentregels worden overtreden.

> [accordion] Eigenschappen
>
> **networks** `object[]` *required*
>
> Of elk netwerk de advertentie kan weergeven. Leeg totdat de beoordeling is afgerond.
>
> > [accordion] Eigenschappen
> >
> > **recommended** `boolean` *required*
> >
> > Of de advertentie voldoet aan het contentbeleid van Whop en van dit netwerk.
> >
> > **title** `string` *required*
> >
> > Het netwerk. `whop` is het eigen contentbeleid van Whop, dat ook door elk ander netwerk wordt vereist.
> >
> > Beschikbare opties: `whop`, `meta`, `tiktok`, `google`
>
> **status** `string` *required*
>
> `reviewed` zodra de contentbeoordeling van Whop is afgerond, `in_review` terwijl deze loopt, `not_reviewed` wanneer deze nooit is uitgevoerd.
>
> Beschikbare opties: `reviewed`, `in_review`, `not_reviewed`
>
> **tags** `object[]` *required*
>
> Elke regel die de advertentie volgens de beoordeling overtreedt, op welk netwerk dan ook. Leeg wanneer er geen regels worden overtreden of de beoordeling nog niet is afgerond.
>
> > [accordion] Eigenschappen
> >
> > **message** `string` *required*
> >
> > Het bewijs dat de beoordeling voor deze regel heeft vastgelegd.
> >
> > **title** `string` *required*
> >
> > De regel die de advertentie volgens de contentbeoordeling van Whop overtreedt.

**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 advertentie is aangemaakt, als ISO 8601-tijdstempel.

**creatives** `object[]` *required*

De creatieve assets die door deze advertentie worden gebruikt. Het originele asset heeft een null-format; square-, vertical- en horizontal-items zijn plaatsingsspecifieke varianten. Een carrouseladvertentie retourneert één item met null-format per bijlage, op volgorde.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De bestands-id van de creatieve bijlage.
>
> **crop** `object | null` *required*
>
> Het opgeslagen uitsnedevenster voor deze creative, in pixels van de bronafbeelding. Null voor het originele asset of een format dat niet is bijgesneden.
>
> > [accordion] Eigenschappen
> >
> > **height** `number` *required*
> >
> > Hoogte van het uitsnedevenster in bronpixels.
> >
> > **width** `number` *required*
> >
> > Breedte van het uitsnedevenster in bronpixels.
> >
> > **x** `number` *required*
> >
> > Linkerrand van het uitsnedevenster in bronpixels.
> >
> > **y** `number` *required*
> >
> > Bovenrand van het uitsnedevenster in bronpixels.
>
> **format** `string | null` *required*
>
> De plaatsingsvariant die dit asset dekt, of null voor het originele asset.
>
> Beschikbare opties: `square`, `vertical`, `horizontal`
>
> **language** `string | null` *required*
>
> Altijd `null`. Vertalingen zijn niet langer beschikbaar.
>
> **media\_type** `string | null` *required*
>
> Het soort asset, afbeelding of video.
>
> **url** `string | null` *required*
>
> CDN-url van het asset.

**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 advertentie op dit moment wordt geleverd, en zo niet, waarom. Wanneer meerdere statussen tegelijk van toepassing zijn, wordt de status met de hoogste prioriteit geretourneerd.

Beschikbare opties: `rejected`, `in_review`, `draft`, `campaign_paused`, `paused`, `processing`, `revise_content`, `issues`, `scheduled`, `learning`, `active`

**descriptions** `object[]` *required*

De beschrijving die op de advertentie wordt getoond.

> [accordion] Eigenschappen
>
> **language** `string | null` *required*
>
> Altijd `null`. Vertalingen zijn niet langer beschikbaar.
>
> **text** `string` *required*
>
> De tekst die aan kijkers wordt getoond.

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

Vertoningen gedeeld door bereik.

**headlines** `object[]` *required*

De kop die op de advertentie wordt getoond.

> [accordion] Eigenschappen
>
> **language** `string | null` *required*
>
> Altijd `null`. Vertalingen zijn niet langer beschikbaar.
>
> **text** `string` *required*
>
> De tekst die aan kijkers wordt getoond.

**impressions** `number` *required*

Het aantal vertoningen.

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

Openstaande problemen die deze advertentie beïnvloeden. Leeg wanneer er geen zijn.

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

**primary\_texts** `object[]` *required*

De primaire tekst die in de hoofdtekst van de advertentie wordt getoond. Meerdere items vormen tekstvariaties.

> [accordion] Eigenschappen
>
> **language** `string | null` *required*
>
> Altijd `null`. Vertalingen zijn niet langer beschikbaar.
>
> **text** `string` *required*
>
> De tekst die aan kijkers wordt getoond.

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

**spend** `number` *required*

Het in rekening gebrachte bedrag, in spend\_currency.

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

De ISO 4217-valutacode van alle monetaire statistieken.

**status** `string` *required*

Of de advertentie is ingeschakeld. `active` en `paused` stel je zelf in; `in_review` en `rejected` komen voort uit de advertentiebeoordeling.

Beschikbare opties: `active`, `paused`, `in_review`, `rejected`

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

**title** `string | null` *required*

Weergavetitel van de advertentie.

**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 advertentie voor het laatst is bijgewerkt, als ISO 8601-tijdstempel.

**url** `string | null` *required*

De URL waarnaar de advertentie linkt, zonder querystring. Parameters horen in `url_parameters`; parameters die je op `url` meestuurt, worden daarheen verplaatst.

**url\_parameters** `object` *required*

Queryparameters die aan `url` worden toegevoegd, met de naam als sleutel. De klikattributieparameters van Whop zijn gereserveerd.

**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 Ad theme={null}
{
	"id": "ad_xxxxxxxxxxxxx",
	"ad_campaign": {
		"id": "adcamp_xxxxxxxxxx"
	},
	"ad_group": {
		"id": "adgrp_xxxxxxxxxxx"
	},
	"added_to_cart_value": 540,
	"added_to_carts": 18,
	"call_to_action": "shop_now",
	"click_through_rate": 0.034,
	"clicks": 420,
	"completed_registration_value": 0,
	"completed_registrations": 12,
	"contact_value": 0,
	"contacts": 8,
	"content_review": {
		"status": "reviewed",
		"networks": [
			{
				"title": "whop",
				"recommended": true
			},
			{
				"title": "meta",
				"recommended": true
			},
			{
				"title": "tiktok",
				"recommended": false
			},
			{
				"title": "google",
				"recommended": true
			}
		],
		"tags": [
			{
				"title": "Unrealistic earnings or investment claims",
				"message": "The ad promises viewers they will make $10,000 a month."
			}
		]
	},
	"cost_per_added_to_cart": 7.22,
	"cost_per_click": 0.31,
	"cost_per_completed_registration": 10.83,
	"cost_per_contact": 16.25,
	"cost_per_lead": 9.29,
	"cost_per_mille": 14.5,
	"cost_per_purchase": 21.67,
	"cost_per_result": 21.67,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.37,
	"cost_per_viewed_content": 0.54,
	"created_at": "2026-06-01T12:00:00Z",
	"creatives": [
		{
			"id": "file_xxxxxxxxxxxx",
			"crop": {
				"height": 1080,
				"width": 1080,
				"x": 120,
				"y": 0
			},
			"format": "square",
			"media_type": "image",
			"url": "https://img.whop.com/file_xxxxxxxxxxxx.jpg",
			"language": null
		}
	],
	"custom_conversions": 4,
	"custom_event_counts": {
		"QualifiedCall": 3,
		"BookedDemo": 1
	},
	"custom_event_values": {
		"QualifiedCall": 1500,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"descriptions": [
		{
			"language": null,
			"text": "Limited spots available this week."
		}
	],
	"frequency": 1.8,
	"headlines": [
		{
			"language": null,
			"text": "Join Pickaxe Pro"
		}
	],
	"impressions": 9000,
	"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": "ad_xxxxxxxxxxxxx",
			"resource_type": "ad"
		}
	],
	"lead_value": 700,
	"leads": 14,
	"link_clicks": 336,
	"primary_texts": [
		{
			"language": null,
			"text": "Build sharper trading habits with daily lessons."
		}
	],
	"purchase_value": 1820,
	"purchases": 6,
	"reach": 5000,
	"result_event": "purchase",
	"result_event_name": null,
	"results": 6,
	"return_on_ad_spend": 14,
	"schedule_value": 0,
	"schedules": 0,
	"spend": 130,
	"spend_currency": "usd",
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"title": "Pickaxe Pro launch ad",
	"unique_click_through_rate": 0.028,
	"unique_clicks": 350,
	"updated_at": "2026-06-02T12:00:00Z",
	"url": "https://whop.com/pickaxe",
	"url_parameters": {
		"utm_campaign": "pickaxe-launch"
	},
	"viewed_content_value": 0,
	"viewed_contents": 240
}
```


## Related topics

- [Overzicht van de Ads API](https://docs.whop.com/nl/api-reference/ads/overview.md)
- [Advertenties](https://docs.whop.com/nl/api-reference/legacy/ads/ad.md)
- [Adverteren met Whop Ads](https://docs.whop.com/nl/developer/ads/overview.md)
