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

# CampaignCreatorElement

> De builder voor advertentiecampagnes: doel en budget, advertentiegroepen met hun targeting en planning, en de advertenties zelf met hun creatives — de hele flow tot aan de lancering. Opent leeg om een nieuwe campagne te bouwen, of op een bestaande campagne wanneer je `campaignId` doorgeeft. Het voert ook de pixelcontrole uit: een lancering kan pas doorgaan als het conversie-event van de advertentiegroep live is op de bestemmings-URL, en de wizard `pixel-setup` opent binnen dit element om een ontbrekende installatie te herstellen. Een lancering vereist ook dat het account de Whop Ads-overeenkomst heeft ondertekend: is dat niet zo, dan opent de handle `ads-agreement` boven de builder en gaat de lancering verder zodra die is ondertekend. Budgetten worden ingevoerd en weergegeven in de `ads_reporting_currency` van het account — de valuta die de rapporten al gebruiken — en omgerekend naar en gefactureerd in USD tegen de actuele wisselkoers. Het ene token dat je op de handle `ads` instelt, moet naast de campagnescopes ook de pixelscopes bevatten — `ad_campaign:create` en `company:basic:read` — in plaats van een apart token per element te gebruiken.

> [!NOTE]
>
> Deze pagina documenteert `@whop/elements@1.10.0` en `@whop/elements-react@1.10.0`.

*Sinds `v1.0.0`.*

Opent als modal vanuit [`Ads`](https://docs.whop.com/nl/elements/latest/ads/overview): `ads.createOverlay('campaign-creator')`. Geef props en callbacks door in de create-opties.

> [!NOTE]
>
> Dit element is **alleen als modal** beschikbaar. Open het met `createOverlay`; het kan niet inline worden gemount.

```tsx React theme={null}
import { WhopElements, Ads, CampaignCreatorElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <CampaignCreatorElement onExited={(e) => console.log(e)} onLaunched={(e) => console.log(e)} />
      </Ads>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const ads = window.WhopElements().ads.create({ /* options */ });
  ads.createOverlay('campaign-creator', {
    onExited: (e) => console.log(e),
    onLaunched: (e) => console.log(e)
  }).open();
</script>
```

Voorbeeldgegevens. [Open de Playground](https://docs.whop.com/nl/elements/latest/ads/overview#playground).

## Props

**campaignId** `string`

De campagne (`adcamp_…`) die moet worden geopend. Leeg bouwt een nieuwe. Een concept opent waar het was gebleven; een gelanceerde campagne opent in de bewerkmodus. Standaard: `""`.

**adGroupId** `string`

De advertentiegroep (`adgrp_…`) die binnen `campaignId` in focus moet worden geopend. Wordt genegeerd als de campagne zo'n groep niet heeft, en als `campaignId` leeg is. Standaard: `""`.

**adId** `string`

De advertentie (`ad_…`) die binnen `adGroupId` in focus moet worden geopend. Wordt genegeerd als die groep zo'n advertentie niet heeft, en als `adGroupId` leeg is. Standaard: `""`.

**initialStep** `"ads" | "ad-groups" | "campaign-settings"`

Bij welke stap het element opent: `campaign-settings`, `ad-groups` of `ads`. Het dashboard deep-linkt dit vanuit de eigen URL; geef het door om een accounteigenaar direct naar het onderdeel te brengen dat hij wilde wijzigen. Wordt één keer gelezen bij het mounten — het later wijzigen verplaatst de gebruiker niet tussen stappen. Standaard: `"campaign-settings"`.

**externalMediaIds** `string[]`

Bestands-ID's (`file_…`) die je app via `POST /api/v1/files` heeft geüpload, aangeboden in de creativebibliotheek van de builder. Ze verschijnen bovenaan de bibliotheeklijst, in deze volgorde, en zolang er ID's zijn ingesteld, openen de mediakiezers op de bibliotheek in plaats van op de uploadzone. Maak de bestanden aan met dezelfde API-sleutel die het `accessToken` van de handle `ads` aanmaakt — de builder leest ze in één batch terug (`GET /api/v1/files`), en bestanden kunnen alleen worden gelezen met de inloggegevens waarmee ze zijn aangemaakt. Geef maximaal 250 ID's door, de limiet van de batchlezing. Een bestand verschijnt zodra de upload volledig is verwerkt; een ID dat nooit klaar is, of dat naar iets anders dan een afbeelding of video verwijst, wordt weggelaten. Geef nieuwe ID's door met `update({ externalMediaIds })` om media te streamen naar een builder die al open is. Standaard: `[]`.

## Events

Geef callbacks door in de create-opties of als React-props.

### `onExited`

De accounteigenaar heeft de builder verlaten zonder te lanceren. Er is niets weggegooid — een conceptcampagne, als die was gestart, is al opgeslagen. Een overlay heeft zichzelf al gesloten wanneer dit wordt geactiveerd; reageer erop als je pagina dat nodig heeft.

### `onLaunched`

Een campagne is live gegaan. `firstLaunch` markeert de allereerste gelanceerde campagne van het account; het dashboard gebruikt dit om de welkomststatus te tonen. Een overlay heeft zichzelf al gesloten; hier stuur je de gebruiker verder.

**payload** `object`

**properties**

**campaignId** `string` *required*

**firstLaunch** `boolean` *required*

### `onLoaderStart`

Wordt uitgevoerd nadat het laadskelet voor het eerst is getekend en vóór `onReady`.

### `onReady`

Wordt uitgevoerd na de eerste volledige weergave van het element.

### `onError`

Wordt uitgevoerd wanneer het element niet laadt of crasht. De fallback blijft zichtbaar. Gebruik `code` voor programmatische afhandeling. `sourceKey` identificeert een mislukte host-state-bron.

**e** `object`

**properties**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Methoden

Roep deze aan op de handle die `create` retourneert, of via een React-`ref`.

### `mount`

Mount het element in `target` en begint met laden. React-componenten mounten zichzelf.

**Parameters**

**target** `string | HTMLElement` *required*

### `destroy`

Verwijdert het element en geeft het frame en de abonnementen ervan vrij. Je kunt dit meer dan eens aanroepen. React verwijdert het element automatisch.

### `update`

Voegt nieuwe props samen in het gemounte element. Wijzig in React in plaats daarvan de props van de component.

**Parameters**

**options** `Partial\<CampaignCreatorElementProps\>` *required*

## Styling

Style deze onderdelen via `appearance.classes`. Gebruik camelCase of kebab-case voor eigenschapsnamen en vermeld eenheden. Stylesheets van de pagina kunnen het frame van het element niet bereiken. Het framework valideert elke declaratie voordat die wordt geïnjecteerd.

| Klasse | Doel |
| - | - |
| `.whop-PixelSetupSurface` | De root van de pixelinstallatiewizard — één stap tegelijk |

```ts theme={null}
const ads = whop.ads.create({
  appearance: {
    classes: {
      'whop-PixelSetupSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

ads.update({
  appearance: {
    classes: { 'whop-PixelSetupSurface': { fontWeight: '700' } }
  }
});
```

Geef in React `appearance` door aan `<Ads>`. Stel het globaal in met `WhopElements({ appearance })`.


## Related topics

- [Ads](https://docs.whop.com/nl/elements/latest/ads/overview.md)
- [AdsAgreementElement](https://docs.whop.com/nl/elements/latest/ads/ads-agreement.md)
- [Rapportage](https://docs.whop.com/nl/elements/latest/ads/reporting.md)
