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

> Een Ad Group bevindt zich binnen een advertentiecampagne en regelt de levering van advertenties. Deze bepaalt de doelgroep, planning en het budget voor de advertenties.

Een Ad Group bevindt zich binnen een [advertentiecampagne](https://docs.whop.com/nl/api-reference/ad-campaigns/ad-campaign) en regelt de levering van [advertenties](https://docs.whop.com/nl/api-reference/ads/ad). Deze bepaalt de doelgroep, planning en het budget voor de advertenties.

Gebruik de Ad Groups API om advertentiegroepen in campagnes aan te maken, targeting- en leveringsinstellingen op te vragen of op te halen, budgetten of targeting bij te werken, groepen te verwijderen die moeten stoppen en de levering te pauzeren of te hervatten.

## Endpoints

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

## Targetingbeperkingen

Advertentiegroepen kunnen zich niet richten op de [landen die in de advertentiegids worden genoemd](https://docs.whop.com/nl/developer/ads/overview.md#countries-you-cannot-target). Verzoeken om een advertentiegroep aan te maken of de getargete landen bij te werken, worden afgewezen als ze een geblokkeerd land bevatten in `regions.include.countries`.

## Attributen

**id** `string` *required*

Unieke identificatie van de advertentiegroep, met prefix `adgrp_`.

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

De advertentiecampagne waartoe deze advertentiegroep 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.

**audiences** `object` *required*

Opgeslagen doelgroepen waaraan deze advertentiegroep levert of die worden uitgesloten.

> [accordion] Eigenschappen
>
> **exclude** `string[]` *required*
>
> ID's van opgeslagen doelgroepen die van levering zijn uitgesloten, met prefix `adaud_`.
>
> **include** `string[]` *required*
>
> ID's van opgeslagen doelgroepen waaraan de advertentiegroep levert, met prefix `adaud_`.

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

Hoe biedingen voor levering in de advertentieveiling worden ingesteld. Op doelen gebaseerde strategieën gebruiken `desired_cost_per_result`.

Beschikbare opties: `minimum_cost`, `average_target`, `maximum_target`

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

Het budget van deze advertentiegroep in USD, de valuta waarin het wordt opgeslagen en gefactureerd. `null` wanneer het budget in plaats daarvan op de campagne is ingesteld.

**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\_type** `string | null` *required*

Of `budget_amount` per dag (`daily`) of over de volledige looptijd van de advertentiegroep (`lifetime`) wordt besteed. Een `lifetime`-advertentiegroep heeft ook `ends_at` nodig, minstens 24 uur na de start.

Beschikbare opties: `daily`, `lifetime`

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

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

Het pixel-event waarop wordt geoptimaliseerd. Een standaard-event of een willekeurige aangepaste pixel-eventnaam.

**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 advertentiegroep 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\_schedule** `object | null` *required*

Uren waarin de advertentiegroep elke week levert, per dag als sleutel. Dagen waarop niet wordt geleverd, worden weggelaten. `null` wanneer op elk uur wordt geleverd. Sommige platforms vereisen een lifetime-`budget_type` voor een planning, op de advertentiegroep of op de campagne wanneer de campagne het budget beheert.

> [accordion] Eigenschappen
>
> **friday** `object[]`
>
> Tijdvensters waarin de advertentiegroep op vrijdag levert, in chronologische volgorde. Weggelaten wanneer er die dag niet wordt geleverd.
>
> > [accordion] Eigenschappen
> >
> > **end** `string` *required*
> >
> > Wanneer de levering stopt, als 24-uurstijd `HH:00` tot en met `24:00` voor middernacht. Later dan `start`; een venster na middernacht wordt over twee dagen verdeeld.
> >
> > **start** `string` *required*
> >
> > Wanneer de levering start, als 24-uurstijd `HH:00` van `00:00` tot en met `23:00`.
>
> **monday** `object[]`
>
> Tijdvensters waarin de advertentiegroep op maandag levert, in chronologische volgorde. Weggelaten wanneer er die dag niet wordt geleverd.
>
> > [accordion] Eigenschappen
> >
> > **end** `string` *required*
> >
> > Wanneer de levering stopt, als 24-uurstijd `HH:00` tot en met `24:00` voor middernacht. Later dan `start`; een venster na middernacht wordt over twee dagen verdeeld.
> >
> > **start** `string` *required*
> >
> > Wanneer de levering start, als 24-uurstijd `HH:00` van `00:00` tot en met `23:00`.
>
> **saturday** `object[]`
>
> Tijdvensters waarin de advertentiegroep op zaterdag levert, in chronologische volgorde. Weggelaten wanneer er die dag niet wordt geleverd.
>
> > [accordion] Eigenschappen
> >
> > **end** `string` *required*
> >
> > Wanneer de levering stopt, als 24-uurstijd `HH:00` tot en met `24:00` voor middernacht. Later dan `start`; een venster na middernacht wordt over twee dagen verdeeld.
> >
> > **start** `string` *required*
> >
> > Wanneer de levering start, als 24-uurstijd `HH:00` van `00:00` tot en met `23:00`.
>
> **sunday** `object[]`
>
> Tijdvensters waarin de advertentiegroep op zondag levert, in chronologische volgorde. Weggelaten wanneer er die dag niet wordt geleverd.
>
> > [accordion] Eigenschappen
> >
> > **end** `string` *required*
> >
> > Wanneer de levering stopt, als 24-uurstijd `HH:00` tot en met `24:00` voor middernacht. Later dan `start`; een venster na middernacht wordt over twee dagen verdeeld.
> >
> > **start** `string` *required*
> >
> > Wanneer de levering start, als 24-uurstijd `HH:00` van `00:00` tot en met `23:00`.
>
> **thursday** `object[]`
>
> Tijdvensters waarin de advertentiegroep op donderdag levert, in chronologische volgorde. Weggelaten wanneer er die dag niet wordt geleverd.
>
> > [accordion] Eigenschappen
> >
> > **end** `string` *required*
> >
> > Wanneer de levering stopt, als 24-uurstijd `HH:00` tot en met `24:00` voor middernacht. Later dan `start`; een venster na middernacht wordt over twee dagen verdeeld.
> >
> > **start** `string` *required*
> >
> > Wanneer de levering start, als 24-uurstijd `HH:00` van `00:00` tot en met `23:00`.
>
> **tuesday** `object[]`
>
> Tijdvensters waarin de advertentiegroep op dinsdag levert, in chronologische volgorde. Weggelaten wanneer er die dag niet wordt geleverd.
>
> > [accordion] Eigenschappen
> >
> > **end** `string` *required*
> >
> > Wanneer de levering stopt, als 24-uurstijd `HH:00` tot en met `24:00` voor middernacht. Later dan `start`; een venster na middernacht wordt over twee dagen verdeeld.
> >
> > **start** `string` *required*
> >
> > Wanneer de levering start, als 24-uurstijd `HH:00` van `00:00` tot en met `23:00`.
>
> **wednesday** `object[]`
>
> Tijdvensters waarin de advertentiegroep op woensdag levert, in chronologische volgorde. Weggelaten wanneer er die dag niet wordt geleverd.
>
> > [accordion] Eigenschappen
> >
> > **end** `string` *required*
> >
> > Wanneer de levering stopt, als 24-uurstijd `HH:00` tot en met `24:00` voor middernacht. Later dan `start`; een venster na middernacht wordt over twee dagen verdeeld.
> >
> > **start** `string` *required*
> >
> > Wanneer de levering start, als 24-uurstijd `HH:00` van `00:00` tot en met `23:00`.

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

Of advertenties in deze advertentiegroep op dit moment worden geleverd, en zo niet, waarom. Wanneer meerdere statussen tegelijk van toepassing zijn, wordt de status met de hoogste prioriteit geretourneerd.

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

**demographics** `object` *required*

Targeting op leeftijd, geslacht en automatische doelgroep.

> [accordion] Eigenschappen
>
> **automatic** `boolean` *required*
>
> Of automatische doelgroeptargeting is ingeschakeld. Wanneer `true`, kan de levering verder reiken dan de ingestelde leeftijden en geslachten, die dan als suggesties worden behandeld.
>
> **gender** `string` *required*
>
> Getarget geslacht.
>
> Beschikbare opties: `all`, `male`, `female`
>
> **maximum\_age** `number | null` *required*
>
> Hoogste getargete leeftijd. `null` wanneer er geen maximum is ingesteld.
>
> **minimum\_age** `number | null` *required*
>
> Laagste getargete leeftijd. `null` wanneer er geen minimum is ingesteld.

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

Kosten per resultaat om naar te streven (`average_target`) of nooit te overschrijden (`maximum_target`). `null` bij `minimum_cost`-bieden.

**devices** `object` *required*

Getargete apparaatplatforms en besturingssystemen.

> [accordion] Eigenschappen
>
> **operating\_systems** `object[]` *required*
>
> Getargete besturingssystemen. Leeg betekent dat alle besturingssystemen worden getarget.
>
> > [accordion] Eigenschappen
> >
> > **minimum\_version** `string`
> >
> > Laagste getargete OS-versie, zoals `18.0`. Afwezig wanneer elke versie in aanmerking komt.
> >
> > **os** `string` *required*
> >
> > Getarget besturingssysteem.
> >
> > Beschikbare opties: `ios`, `android`
>
> **platforms** `string[]` *required*
>
> Getargete apparaattypen. Leeg betekent dat alle apparaten worden getarget.
>
> Beschikbare opties: `mobile`, `desktop`

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

Wanneer de advertentiegroep stopt met leveren, als ISO 8601-tijdstempel. `null` wanneer deze loopt totdat ze wordt gepauzeerd.

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

Vertoningen gedeeld door bereik.

**impressions** `number` *required*

Het aantal vertoningen.

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

Openstaande problemen die deze advertentiegroep en de advertenties ervan 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.

**keywords** `object[]`

Zoektermen waarvoor de advertenties van deze advertentiegroep kunnen worden weergegeven, en termen waarvoor ze nooit worden weergegeven. Alleen voor zoekcampagnes, waarbij elke advertentiegroep er vóór de lancering minstens één nodig heeft.

> [accordion] Eigenschappen
>
> **match\_type** `string` *required*
>
> Hoe nauwkeurig een zoekopdracht moet overeenkomen: `broad` bereikt ook gerelateerde zoekopdrachten, `phrase` vereist de betekenis van de woordgroep en `exact` vereist dezelfde betekenis als de term. Standaard `broad`.
>
> Beschikbare opties: `broad`, `phrase`, `exact`
>
> **negative** `boolean` *required*
>
> Of deze term voorkomt dat de advertenties worden weergegeven in plaats van ze in aanmerking te laten komen. Standaard `false`.
>
> **text** `string` *required*
>
> De zoekterm, maximaal 80 tekens en 10 woorden.

**languages** `string[]` *required*

Getargete talen, als ISO 639-codes zoals `en` of `es`. Een regiospecifieke locale zonder ISO-code verschijnt als numerieke locale-sleutel. Leeg betekent dat alle talen worden getarget.

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

**learning\_progress** `object | null` *required*

Voortgang richting de conversies die de leerfase van deze advertentiegroep nodig heeft. Null, tenzij de groep aan het leren is of beperkt aan het leren is en er geldige aantallen beschikbaar zijn. Het bereiken van de drempel bepaalt de leveringsstatus niet.

> [accordion] Eigenschappen
>
> **conversion\_threshold** `integer` *required*
>
> De conversies die de leerfase van deze advertentiegroep nodig heeft. Dit kan tijdens de levering veranderen.
>
> **conversions** `integer` *required*
>
> Conversies geteld sinds de laatste significante wijziging tijdens de leerfase van deze advertentiegroep.
>
> **progress\_percent** `number` *required*
>
> Conversies gedeeld door de drempel, als percentage begrensd tot 0–100. De `delivery_status` van de advertentiegroep blijft leidend.

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

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

**regions** `object` *required*

Getargete en uitgesloten locaties.

> [accordion] Eigenschappen
>
> **exclude** `object` *required*
>
> Locaties die van targeting zijn uitgesloten. Landengroepen kunnen niet worden uitgesloten.
>
> > [accordion] Eigenschappen
> >
> > **cities** `object[]` *required*
> >
> > Steden, met de locatietaxonomie als sleutel.
> >
> > > [accordion] Eigenschappen
> > >
> > > **key** `string` *required*
> > >
> > > De sleutel van de stad in de locatietaxonomie.
> > >
> > > **name** `string`
> > >
> > > Naam van de stad, zoals `Austin`. Afwezig wanneer de locatietaxonomie er geen heeft.
> >
> > **countries** `string[]` *required*
> >
> > Landen, als ISO 3166-1 alpha-2-codes zoals `US`.
> >
> > **country\_groups** `string[]` *required*
> >
> > Groepen van meerdere landen, zoals `worldwide` of `europe`.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Cirkelvormige gebieden, elk een coördinaat plus een straal.
> >
> > > [accordion] Eigenschappen
> > >
> > > **country\_code** `string`
> > >
> > > ISO 3166-1 alpha-2-land waarin het punt ligt. Stuur dit mee bij een speciale advertentiecategorie, waarbij de campagne de landen moet opgeven die de advertentiesets bereiken.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > Eenheid voor `radius`.
> > >
> > > Beschikbare opties: `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Breedtegraad van het middelpunt.
> > >
> > > **longitude** `number` *required*
> > >
> > > Lengtegraad van het middelpunt.
> > >
> > > **name** `string`
> > >
> > > Label voor de locatie, zoals een stad of adres. Afwezig wanneer de locatie geen label heeft.
> > >
> > > **radius** `number` *required*
> > >
> > > Straal rond het middelpunt, in `distance_unit`.
> >
> > **regions** `string[]` *required*
> >
> > Amerikaanse staten en DC, als ISO 3166-2-codes zoals `US-CA`. Amerikaanse territoria (`PR`, `GU`, `VI`, `AS`, `MP`) en alles buiten de VS worden getarget via `countries`.
> >
> > **zips** `string[]` *required*
> >
> > Postcodes, met als sleutel `COUNTRY:CODE`, zoals `US:78756`.
>
> **include** `object` *required*
>
> Locaties waarop de advertentiegroep zich richt.
>
> > [accordion] Eigenschappen
> >
> > **cities** `object[]` *required*
> >
> > Steden, met de locatietaxonomie als sleutel.
> >
> > > [accordion] Eigenschappen
> > >
> > > **key** `string` *required*
> > >
> > > De sleutel van de stad in de locatietaxonomie.
> > >
> > > **name** `string`
> > >
> > > Naam van de stad, zoals `Austin`. Afwezig wanneer de locatietaxonomie er geen heeft.
> >
> > **countries** `string[]` *required*
> >
> > Landen, als ISO 3166-1 alpha-2-codes zoals `US`.
> >
> > **country\_groups** `string[]` *required*
> >
> > Groepen van meerdere landen, zoals `worldwide` of `europe`.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Cirkelvormige gebieden, elk een coördinaat plus een straal.
> >
> > > [accordion] Eigenschappen
> > >
> > > **country\_code** `string`
> > >
> > > ISO 3166-1 alpha-2-land waarin het punt ligt. Stuur dit mee bij een speciale advertentiecategorie, waarbij de campagne de landen moet opgeven die de advertentiesets bereiken.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > Eenheid voor `radius`.
> > >
> > > Beschikbare opties: `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Breedtegraad van het middelpunt.
> > >
> > > **longitude** `number` *required*
> > >
> > > Lengtegraad van het middelpunt.
> > >
> > > **name** `string`
> > >
> > > Label voor de locatie, zoals een stad of adres. Afwezig wanneer de locatie geen label heeft.
> > >
> > > **radius** `number` *required*
> > >
> > > Straal rond het middelpunt, in `distance_unit`.
> >
> > **regions** `string[]` *required*
> >
> > Amerikaanse staten en DC, als ISO 3166-2-codes zoals `US-CA`. Amerikaanse territoria (`PR`, `GU`, `VI`, `AS`, `MP`) en alles buiten de VS worden getarget via `countries`.
> >
> > **zips** `string[]` *required*
> >
> > Postcodes, met als sleutel `COUNTRY:CODE`, zoals `US:78756`.

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

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

Wanneer de advertentiegroep begint met leveren, als ISO 8601-tijdstempel. `null` wanneer deze start zodra ze actief is.

**status** `string` *required*

Of de advertentiegroep is ingeschakeld. `active` en `paused` stel je zelf in; `rejected` betekent dat de groep de advertentiebeoordeling niet heeft doorstaan; `duplicating` is een kopie die nog wordt gevuld.

Beschikbare opties: `active`, `paused`, `rejected`, `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.

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

Weergavenaam van de advertentiegroep.

**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 advertentiegroep 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 AdGroup theme={null}
{
	"id": "adgrp_xxxxxxxxxxx",
	"ad_campaign": {
		"id": "adcamp_xxxxxxxxxx"
	},
	"added_to_cart_value": 1050,
	"added_to_carts": 24,
	"audiences": {
		"exclude": [],
		"include": ["adaud_xxxxxxxxxxx"]
	},
	"bid_type": "minimum_cost",
	"budget_amount": 100,
	"budget_amount_local": 100,
	"budget_currency": "usd",
	"budget_type": "daily",
	"click_through_rate": 0.036,
	"clicks": 720,
	"completed_registration_value": 0,
	"completed_registrations": 16,
	"contact_value": 0,
	"contacts": 10,
	"conversion_event": "purchase",
	"cost_per_added_to_cart": 8.33,
	"cost_per_click": 0.28,
	"cost_per_completed_registration": 12.5,
	"cost_per_contact": 20,
	"cost_per_lead": 13.33,
	"cost_per_mille": 10,
	"cost_per_purchase": 25,
	"cost_per_result": 25,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.33,
	"cost_per_viewed_content": 0.67,
	"created_at": "2026-06-01T12:00:00Z",
	"custom_conversions": 5,
	"custom_event_counts": {
		"QualifiedCall": 4,
		"BookedDemo": 1
	},
	"custom_event_values": {
		"QualifiedCall": 2000,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"learning_progress": null,
	"demographics": {
		"automatic": false,
		"minimum_age": 21,
		"maximum_age": 45,
		"gender": "all"
	},
	"delivery_schedule": {
		"monday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"tuesday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"wednesday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"thursday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"friday": [
			{
				"start": "09:00",
				"end": "12:00"
			},
			{
				"start": "16:00",
				"end": "20:00"
			}
		],
		"saturday": [
			{
				"start": "10:00",
				"end": "14:00"
			}
		],
		"sunday": [
			{
				"start": "12:00",
				"end": "16:00"
			}
		]
	},
	"desired_cost_per_result": 30,
	"devices": {
		"platforms": ["mobile", "desktop"],
		"operating_systems": [
			{
				"os": "ios",
				"minimum_version": "18.0"
			}
		]
	},
	"ends_at": "2026-07-01T12:00:00Z",
	"frequency": 1.6,
	"impressions": 20000,
	"issues": [
		{
			"id": "adiss_xxxxxxxxxxx",
			"category": "error",
			"title": "Ad issue",
			"message": "The audience is too narrow to deliver. Broaden the targeting to reach more people.",
			"resource_id": "adgrp_xxxxxxxxxxx",
			"resource_type": "ad_group"
		}
	],
	"languages": ["en"],
	"lead_value": 750,
	"leads": 15,
	"link_clicks": 576,
	"purchase_value": 5200,
	"purchases": 8,
	"reach": 12500,
	"regions": {
		"include": {
			"countries": ["US"],
			"country_groups": [],
			"regions": ["US-CA"],
			"cities": [
				{
					"key": "2418779",
					"name": "Miami"
				}
			],
			"zips": [],
			"custom_locations": [
				{
					"latitude": 30.2672,
					"longitude": -97.7431,
					"radius": 10,
					"distance_unit": "mile",
					"name": "Austin, TX"
				}
			]
		},
		"exclude": {
			"countries": [],
			"country_groups": [],
			"regions": [],
			"cities": [
				{
					"key": "2421215",
					"name": "Anchorage"
				}
			],
			"zips": [],
			"custom_locations": [
				{
					"latitude": 40.758,
					"longitude": -73.9855,
					"radius": 2,
					"distance_unit": "mile",
					"name": "Times Square"
				}
			]
		}
	},
	"result_event": "purchase",
	"result_event_name": null,
	"results": 8,
	"return_on_ad_spend": 26,
	"schedule_value": 0,
	"schedules": 0,
	"spend": 200,
	"spend_currency": "usd",
	"starts_at": "2026-06-01T12:00:00Z",
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"title": "US founders",
	"unique_click_through_rate": 0.03,
	"unique_clicks": 600,
	"updated_at": "2026-06-02T12:00:00Z",
	"viewed_content_value": 0,
	"viewed_contents": 300
}
```


## Related topics

- [Advertentiegroepen](https://docs.whop.com/nl/api-reference/legacy/ad-groups/ad-group.md)
- [Delete an Ad Group](https://docs.whop.com/nl/api-reference/ad-groups/delete-an-ad-group.md)
- [Create an Ad Group](https://docs.whop.com/nl/api-reference/ad-groups/create-an-ad-group.md)
