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

# PixelSetupElement

> Installeert de Whop Pixel en koppelt conversie-events: kopieer het fragment, controleer een pagina erop en bevestig dat de events afgaan. Mount het inline, of binnen je eigen overlay.

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

*Sinds `v1.0.0`.*

Wordt gemount binnen [`Websites`](https://docs.whop.com/nl/elements/latest/websites/overview). Geef props en callbacks door via de create-opties of als React-props.

> [!NOTE]
>
> Je kunt dit element **inline** mounten (`create`) of openen als **modale** overlay (`createOverlay`).

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Websites /* options */>
        <PixelSetupElement onRedirectUrlChanged={(e) => console.log(e)} onScanned={(e) => console.log(e)} onFinished={(e) => console.log(e)} onUrlSubmitted={(e) => console.log(e)} onVerifyLaunched={(e) => console.log(e)} onVerifyConnected={(e) => console.log(e)} onVerdict={(e) => console.log(e)} onEventVerified={(e) => console.log(e)} />
      </Websites>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const websites = window.WhopElements().websites.create({ /* options */ });
  websites.create('pixel-setup', {
    onRedirectUrlChanged: (e) => console.log(e),
    onScanned: (e) => console.log(e),
    onFinished: (e) => console.log(e),
    onUrlSubmitted: (e) => console.log(e),
    onVerifyLaunched: (e) => console.log(e),
    onVerifyConnected: (e) => console.log(e),
    onVerdict: (e) => console.log(e),
    onEventVerified: (e) => console.log(e)
  }).mount('#websites-pixel-setup');
</script>
```

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

## Props

**accountId** `string`

Account-ID, met prefix `biz_`, waarvan dit de pixel is. Verplicht; het fragment, de scans en de uitnodigingen draaien er allemaal tegen. Standaard `""`.

**accessToken** `string`

Een token met beperkte scopes voor de scans en de ontwikkelaarsuitnodiging. De scans hebben `company:basic:read` nodig; "Invite a developer" heeft daarnaast `authorized_user:create` nodig, en de event-presets lezen het account met `company:balance:read` (zonder die scope werkt de wizard nog steeds, met een generieke presetlijst). Als er geen `destinationUrl` wordt doorgegeven, stelt het lege URL-veld ook pagina's voor uit de advertenties en het pixelverkeer van het account — die leesacties hebben `ad_campaign:basic:read` en `stats:read` nodig, en zonder die scopes blijft het veld gewoon leeg. Maak het token op je server aan met `POST /api/v1/access_tokens` en stel een nieuw token in voordat het verloopt. Een ander element dat deze wizard binnen zichzelf opent — zoals de ads-`campaign-creator` — voert deze calls uit met zijn eigen token, dus voeg deze scopes toe aan dat ene token in plaats van een tweede aan te maken: dit element kan een referentie die je elders instelt niet lezen. Zonder token gebruiken de calls de eigen sessie van de kijker, die alleen same-origin antwoordt.

**destinationUrl** `string`

De pagina die moet worden gecontroleerd, gescand bij het mounten. Laat je het leeg, dan vraagt de wizard erom. Bepaalt ook of "Verify live" beschikbaar is in de events-stap — die knop leidt de accounteigenaar door zijn eigen funnel om events op te vangen die een server-side scan niet kan zien, dus hij verschijnt pas zodra er een bestemming bekend is, hier opgegeven of in de wizard genoemd. Wordt één keer bij het opstarten gelezen, dus `update()` wijzigt het doel niet halverwege de flow — maak een nieuwe mount aan voor een andere pagina. Standaard `""`.

**eventName** `string`

Optioneel. Een event dat op die pagina moet afgaan (`lead`, `schedule`, `view_content`, …); de events-stap blokkeert totdat het is gedetecteerd. Niet ingesteld, dan wordt elk event aangeboden en is geen enkel event verplicht. Events die Whop server-side vastlegt (`purchase`, `subscribe`, proefperiodes, checkoutstappen) worden genegeerd. Wordt één keer bij het opstarten gelezen. Standaard `""`.

**redirectUrl** `string`

Een URL waarnaar de bestemming doorverwijst, wanneer het event daar afgaat. De accounteigenaar kan er ook een instellen in de wizard — luister naar `redirectUrlChanged` en geef de URL de volgende keer terug. Standaard `""`.

**initialStep** `"events" | "install"`

Waar de wizard opent: bij de installatiestap, of direct bij `events` wanneer de pixel er al is en alleen het conversie-event ontbreekt. Standaard `"install"`.

**showIntro** `boolean`

Opent op het introscherm "waarom een pixel". Zet dit uit waar de accounteigenaar al weet waarom die hier is — een campagneflow die hem halverwege de lancering hierheen stuurt — en de wizard opent direct bij de installatiestap. Standaard `true`.

**showInviteDeveloper** `boolean`

Biedt de optie "Invite a developer to install it". Verberg deze waar de gebruikers van je embed geen leden zouden moeten uitnodigen voor het Whop-team erachter. Standaard `true`.

**showOptimizePrompt** `boolean`

Toont het scherm "je pixel is live" nadat een pagina door de controle is gekomen, dat conversie-events als volgende stap aanbiedt. Zet dit uit waar de accounteigenaar juist voor de events zelf kwam — een geslaagde controle gaat dan direct daarnaartoe, in plaats van te pauzeren op een scherm waar hij doorheen zou klikken. Standaard `true`.

**verifyFirst** `boolean`

Begint met de paginacontrole in plaats van met de installatie-instructies: het URL-veld (en de suggesties ervan) staat bovenaan, de installatieopties worden ingeklapt onder een toggle "Pixel not installed yet?", en de koptekst luidt "Verify your pixel". Voor een accounteigenaar die al een pixel heeft en wil uitzoeken waarom er niets wordt toegeschreven. Combineer het met `showIntro: false`. Standaard `false`.

## Events

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

### `onRedirectUrlChanged`

De accounteigenaar heeft in de wizard een redirect-URL ingesteld of gewist. Sla deze op en geef hem de volgende keer terug als `redirectUrl`.

**payload** `object`

**properties**

**url** `string` *required*

### `onScanned`

Een pixelscan is afgerond. Wordt geactiveerd voor elke URL die de wizard controleert, zodat je eigen installatiebadge die kan volgen. `primary` markeert de pagina die wordt ingesteld: de funnelchecker scant alles wat de accounteigenaar verder opgeeft, inclusief andere hostnamen, dus controleer hierop voordat je een resultaat behandelt als iets dat over hun site gaat. Je hebt dit niet nodig om een `websites`-tabel actueel te houden — wanneer het onder die handle is gemount, krijgt een site waarvan bewezen is dat die live is al zijn wachtende rij.

**payload** `object`

**properties**

**url** `string` *required*

**status** `"installed" | "missing" | "unreachable"` *required*

**installed** `boolean` *required*

**primary** `boolean` *required*

### `onFinished`

Er is op Done gedrukt. Controleer de pagina zelf opnieuw — dit betekent dat de wizard klaar is, niet dat aan je vereisten is voldaan.

### `onUrlSubmitted`

De accounteigenaar heeft vanuit de wizard de te controleren pagina opgegeven — handmatig getypt of gekozen uit de voorgestelde pagina's. Alleen bereikbaar wanneer er bij het mounten geen bestemming is opgegeven.

**payload** `object`

**properties**

**url** `string` *required*

**source** `"typed" | "suggested"` *required*

### `onVerifyLaunched`

Er is op "Verify live" gedrukt. `popupBlocked` betekent dat de browser het funnelvenster heeft geweigerd, waardoor de doorloop nooit is gestart.

**payload** `object`

**properties**

**url** `string` *required*

**popupBlocked** `boolean` *required*

### `onVerifyConnected`

De funnelpagina heeft de wizard teruggepingd — de pixel is daar geladen en de doorloop is live.

**payload** `object`

**properties**

**url** `string` *required*

### `onVerdict`

De verify-live-doorloop is voltooid. `ok` betekent geen hiaten in de tracking; anders bevat `gaps` de hiaatcodes die de doorloop heeft gevonden.

**payload** `object`

**properties**

**url** `string` *required*

**ok** `boolean` *required*

**gaps** `string[]` *required*

**eventsCaptured** `number` *required*

### `onEventVerified`

De accounteigenaar heeft zijn funnel doorlopen met "Verify live" en dit event is afgegaan — het bewijs dat het is gekoppeld op een plek die een server-side scan niet kan bereiken.

**payload** `object`

**properties**

**url** `string` *required*

**event** `string` *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\<PixelSetupElementProps\>` *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 websites = whop.websites.create({
  appearance: {
    classes: {
      'whop-PixelSetupSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

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

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


## Related topics

- [Websites](https://docs.whop.com/nl/elements/latest/websites/overview.md)
- [CampaignCreatorElement](https://docs.whop.com/nl/elements/latest/ads/campaign-creator.md)
- [Aan de slag met Elements](https://docs.whop.com/nl/elements/latest/getting-started.md)
