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

# Send hændelser fra serveren

> Send konverteringshændelser fra din server, og knyt dem til den besøgende, som Whop Pixel allerede sporer.

Events API er serversidens modstykke til [Whop Pixel](https://docs.whop.com/da/developer/ads/pixel.md). [`POST /events`](https://docs.whop.com/da/api-reference/events/create-event) accepterer de samme hændelser, som pixlen sender fra browseren, så du kan rapportere konverteringer, der sker steder, hvor ingen pixel kører. Det dækker et salg, der lukkes i dit CRM, en betaling på din egen backend, en webhook fra en formular eller et bookingværktøj, eller et opkald, som en sælger markerer som booket.

> [!NOTE]
>
> **Før du starter** skal du have tre ting:
>
> * [Whop Pixel](https://docs.whop.com/da/developer/ads/pixel.md) installeret på alle sider i din tragt. Den opretter det besøgende-ID, som denne guide sender videre.
> * En API-nøgle med tilladelsen `event:create`. [Opret en](https://whop.com/dashboard/developer) under **Account API Keys**, og opbevar den på din server. Læg den aldrig i browserkode.
> * Dit konto-ID, den del af din dashboard-URL efter `dashboard/`, der starter med `biz_`.

## Hvornår du skal bruge Events API

De fleste integrationer har ikke brug for dette. Pixlen rapporterer allerede alt, hvad der sker i browseren, og den udfylder selv besøgende-ID, IP-adresse og user agent. Brug kun Events API, når din server er det eneste sted, der ved, at en konvertering er sket. Hvis et `whop.track`-kald kan udløses der, hvor handlingen sker, skal du bruge det i stedet.

## Send en serverhændelse

### 1. Læs besøgende-ID'et i browseren

Pixlen gemmer hver besøgendes ID i en førsteparts-cookie ved navn `_wuid` på dit domæne og spejler det til `localStorage` under den samme nøgle. Værdien ser ud som `wuid_k3j9x2m1p8q4r7s0t5u6`. Læs den i det øjeblik, den besøgende udfører den handling, du senere vil rapportere, ikke ved sideindlæsning. Cookien findes først, når pixel-snippet'en er kørt på siden.

```html Read the visitor ID theme={null}
<script>
  function whopVisitorId() {
    const match = document.cookie.match(/(?:^|;\s*)_wuid=([^;]*)/);
    if (match) return match[1];
    try {
      return localStorage.getItem("_wuid") || undefined;
    } catch {
      return undefined;
    }
  }
</script>
```

Hvert underdomæne får sin egen `_wuid`. Pixlen knytter dem til én person, så læs den cookie, der findes på den side, hvor overdragelsen sker.

### 2. Send det til din server sammen med handlingen

Vedhæft besøgende-ID'et til den anmodning, der allerede bringer handlingen til din backend: en formularindsendelse, et checkout-kald, en tilmeldingsanmodning. Registrér sidens URL på samme tid. Den indeholder de UTM'er og klik-ID'er, som din server ellers ikke kan se.

```html Hidden form fields theme={null}
<form id="quote-form" action="/api/quotes" method="post">
  <input type="email" name="email" required />
  <input type="hidden" name="whop_visitor_id" />
  <input type="hidden" name="whop_page_url" />
  <button type="submit">Get a quote</button>
</form>

<script>
  document.getElementById("quote-form").addEventListener("submit", (e) => {
    e.target.whop_visitor_id.value = whopVisitorId() || "";
    e.target.whop_page_url.value = location.href;
  });
</script>
```

```html JSON request theme={null}
<script>
  async function submitQuote(email) {
    await fetch("/api/quotes", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        email,
        whop_visitor_id: whopVisitorId(),
        whop_page_url: location.href,
      }),
    });
  }
</script>
```

```javascript Same-host backend (Node) theme={null}
app.post("/api/quotes", (req, res) => {
  const lead = {
    email: req.body.email,
    whop_visitor_id: req.cookies._wuid,
    whop_page_url: req.body.whop_page_url,
  };
  // Store the lead, then respond.
});
```

Hvis din backend svarer på den samme vært som siden, kommer `_wuid`-cookien automatisk med anmodningen. Læs den der i stedet for at sende den fra browseren. Cookien er kun sat for den vært, så en anmodning fra `example.com` til `api.example.com` medbringer den ikke.

Din server ser allerede den besøgendes IP-adresse og user agent på den anmodning. Gem begge.

### 3. Gem det på kundeposten

Gem besøgende-ID, side-URL, IP-adresse og user agent på leadet, kunden eller ordren. Den konvertering, du rapporterer, kan ske flere dage efter besøget. En aftale, som dit salgsteam lukker i næste uge, har stadig brug for besøgende-ID'et fra det oprindelige besøg for at kunne tilskrives. Whop accepterer hændelser, der er op til 28 dage gamle.

### 4. Send hændelsen

Post hændelsen fra din server med din API-nøgle. Eksemplet rapporterer et lead fra en besøgende, der kom fra en annonce, udfyldte en tilbudsformular og derefter blev kvalificeret i et CRM.

```bash cURL theme={null}
curl -X POST https://api.whop.com/api/v1/events \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "biz_xxxxxxxxxxxxx",
    "event_name": "lead",
    "event_id": "lead_8f21c0",
    "event_time": "2026-09-03T14:32:11Z",
    "action_source": "website",
    "url": "https://example.com/quote?utm_meta_ad_id=120215678901234567&utm_meta_adset_id=120215678901234566&utm_meta_campaign_id=120215678901234565&utm_source=fb&utm_placement=Facebook_Mobile_Feed&utm_medium=paid_social&utm_content=Ceramic%20coating%20reel&utm_adset=Austin%20SUV%20owners&wacid=adcamp_xxxxxxxxxx&wasid=adgrp_xxxxxxxxxxx&waid=ad_xxxxxxxxxxxxx&fbclid=IwAR0example",
    "user": {
      "anonymous_id": "wuid_k3j9x2m1p8q4r7s0t5u6",
      "email": "amara@example.com",
      "phone": "+15125550137",
      "first_name": "Amara",
      "last_name": "Okafor",
      "external_id": "crm_8842"
    },
    "context": {
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15",
      "fbclid": "IwAR0example",
      "utm_source": "fb"
    }
  }'
```

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

await client.events.create({
  account_id: "biz_xxxxxxxxxxxxx",
  event_name: "lead",
  event_id: "lead_8f21c0",
  event_time: "2026-09-03T14:32:11Z",
  action_source: "website",
  url: "https://example.com/quote?utm_meta_ad_id=120215678901234567&utm_meta_adset_id=120215678901234566&utm_meta_campaign_id=120215678901234565&utm_source=fb&utm_placement=Facebook_Mobile_Feed&utm_medium=paid_social&utm_content=Ceramic%20coating%20reel&utm_adset=Austin%20SUV%20owners&wacid=adcamp_xxxxxxxxxx&wasid=adgrp_xxxxxxxxxxx&waid=ad_xxxxxxxxxxxxx&fbclid=IwAR0example",
  user: {
    anonymous_id: "wuid_k3j9x2m1p8q4r7s0t5u6",
    email: "amara@example.com",
    phone: "+15125550137",
    first_name: "Amara",
    last_name: "Okafor",
    external_id: "crm_8842",
  },
  context: {
    ip_address: "203.0.113.42",
    user_agent: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15",
    fbclid: "IwAR0example",
    utm_source: "fb",
  },
});
```

```python Python theme={null}
import os
from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

client.events.create(
    account_id="biz_xxxxxxxxxxxxx",
    event_name="lead",
    event_id="lead_8f21c0",
    event_time="2026-09-03T14:32:11Z",
    action_source="website",
    url="https://example.com/quote?utm_meta_ad_id=120215678901234567&utm_meta_adset_id=120215678901234566&utm_meta_campaign_id=120215678901234565&utm_source=fb&utm_placement=Facebook_Mobile_Feed&utm_medium=paid_social&utm_content=Ceramic%20coating%20reel&utm_adset=Austin%20SUV%20owners&wacid=adcamp_xxxxxxxxxx&wasid=adgrp_xxxxxxxxxxx&waid=ad_xxxxxxxxxxxxx&fbclid=IwAR0example",
    user={
        "anonymous_id": "wuid_k3j9x2m1p8q4r7s0t5u6",
        "email": "amara@example.com",
        "phone": "+15125550137",
        "first_name": "Amara",
        "last_name": "Okafor",
        "external_id": "crm_8842",
    },
    context={
        "ip_address": "203.0.113.42",
        "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15",
        "fbclid": "IwAR0example",
        "utm_source": "fb",
    },
)
```

`url` i eksemplet er det, en besøgende lander på efter at have trykket på en Whop-annonce på Meta. `utm_meta_ad_id`, `utm_meta_adset_id` og `utm_meta_campaign_id` er netværkets ID'er. `wacid`, `wasid` og `waid` er Whop-kampagne-, annoncegruppe- og annonce-ID'erne. `utm_source` angiver fladen (`fb`, `ig`, `msg` eller `an`), `utm_placement` placeringen, `utm_content` og `utm_adset` navnene på annoncen og annoncegruppen, og `fbclid` er det tag, som netværket selv tilføjer. Whop afgør ud fra disse, hvilken annonce der førte til besøget, så gem hele URL'en i stedet for at plukke parametre ud af den.

Svaret returnerer det gemte hændelses-ID. Whop sætter kontoen foran dit `event_id`, så ID'er fra forskellige konti aldrig kolliderer:

```json theme={null}
{ "id": "biz_xxxxxxxxxxxxx:lead_8f21c0" }
```

### 5. Bekræft, at den landede på den rigtige person

[List Events](https://docs.whop.com/da/api-reference/events/list-events.md) accepterer et besøgende-ID som `identifier`, så du kan læse hele den rejse, som hændelsen blev en del af. Anmodningen kræver en nøgle med en læsetilladelse såsom `company:basic:read`.

```bash cURL theme={null}
curl "https://api.whop.com/api/v1/events?identifier=wuid_k3j9x2m1p8q4r7s0t5u6" \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

Din serverhændelse vises ved siden af pixlens sidevisninger med det samme `person_id`. Hvis sidevisningerne er der, men din hændelse ikke er, matchede besøgende-ID'et ikke. Se [Fejlfinding](#troubleshooting). Hændelsen vises også på [siden Events](https://whop.com/dashboard/events) i dit dashboard.

## Parametre, der afgør tilskrivning

Kun `account_id` og `event_name` er påkrævet. Resten af payloaden er det, der gør hændelsen tilskrivbar, så behandl også disse som påkrævede.

| Felt | Hvad der skal sendes |
| - | - |
| `user.anonymous_id` | Besøgende-ID'et fra `_wuid`-cookien. Dette er det ene felt, der knytter en serverhændelse til den browsersession, der kom fra annoncen. Uden det kan Whop kun matche på e-mail eller telefon. |
| `user.email`, `user.phone` | Almindelig tekst, præcis som kunden indtastede dem. Whop matcher på disse, når pixlen har registreret dem tidligere. En hashet e-mail kasseres som ugyldig. |
| `user.first_name`, `user.last_name`, `user.external_id` | Hvad du ellers ved. `external_id` er dit eget kunde-ID. |
| `event_id` | Et stabilt ID for netop denne handling: dit ordrenummer, aftale-ID eller formularindsendelses-ID. Whop gemmer hvert par af `event_name` og `event_id` én gang, så et genforsøg eller en ekstra kopi af den samme konvertering samles i én hændelse. Se [Undgå dobbelte hændelser](#avoid-duplicate-events). |
| `event_time` | Hvornår handlingen skete, som et ISO 8601-tidsstempel. Standard er nu. Whop afviser alt, der er ældre end 28 dage, og begrænser fremtidige tidsstempler til nu. Send det reelle tidspunkt, ikke det tidspunkt, dit job kørte. |
| `value`, `currency` | Den monetære værdi og dens ISO 4217-kode med små bogstaver, såsom `usd`. Valgfri på de fleste hændelser. Påkrævet og større end nul på `purchase`. |
| `url` | Den side, den besøgende var på, da handlingen startede, inklusive dens query string. Ved et besøg fra en Whop-annonce indeholder den query string de ID'er, som Whop udleder kampagnen, annoncegruppen og annoncen fra. |
| `context.ip_address`, `context.user_agent` | Den besøgendes, kopieret fra deres oprindelige browseranmodning. Whop læser kun disse fra forbindelsen ved uautentificerede browserkald. Et serverkald får intet udledt, så en hændelse uden dem har ingen enheds- eller placeringssignaler. |
| `context.fbclid`, `context.gclid`, `context.ttclid`, `context.utm_*` | Annoncenetværkets ID'er og `utm_*`-parametre fra landingssidens URL, hvis du har gemt dem. |
| `context.fbp`, `context.fbc` | Metas `_fbp`- og `_fbc`-cookieværdier fra den besøgendes browser, hvis du har registreret dem. |
| `action_source` | Hvor handlingen skete: `website`, `app`, `email`, `phone_call`, `chat`, `physical_store`, `system_generated`, `business_messaging` eller `other`. |

Det fulde anmodningsskema findes på referencesiden [Create Event](https://docs.whop.com/da/api-reference/events/create-event.md).

## Navngiv hændelsen

Brug de samme navne som pixlen. Et `lead`, du rapporterer fra din server, lander som den samme hændelse som et `lead`, pixlen rapporterer, så det tæller med i resultaterne for en kampagne, der bedømmes på leads.

| Hændelse | Hvornår den skal sendes |
| - | - |
| `lead` | En besøgende indsender kontaktoplysninger eller en tilmeldingsformular |
| `schedule` | En besøgende booker et opkald eller en aftale |
| `submit_application` | En besøgende indsender en ansøgning |
| `contact` | En besøgende starter en samtale eller kontaktanmodning |
| `complete_registration` | En tilmelding eller registrering afsluttes |
| `view_content` | En besøgende ser en vigtig side eller et vigtigt stykke indhold |
| `add_to_cart` | En besøgende lægger en vare i en kurv |
| `initiate_checkout` | En besøgende når til checkout |
| `purchase` | Et salg gennemføres på din egen checkout. `value` er påkrævet |

Ethvert andet `event_name` bliver en tilpasset hændelse under det navn. Hold navne korte og stabile, og genbrug et lille sæt.

```json Custom event theme={null}
{ "account_id": "biz_xxxxxxxxxxxxx", "event_name": "deal_closed", "value": 2400, "currency": "usd" }
```

> [!WARNING]
>
> Send aldrig `purchase` for et salg, som Whop har behandlet. Whop registrerer automatisk alle checkouts, køb, abonnementer og prøveperioder på sin egen checkout og rapporterer dem til annoncenetværket. Send kun hændelser, som Whop ikke kan se.

## Undgå dobbelte hændelser

Hvis den samme konvertering kan nå Whop både fra browseren og din server, skal du sende den fra begge med det samme `event_name` og det samme `event_id`. Whop beholder én kopi. Dette er den sikreste opsætning, når en formular udløser `whop.track("lead", { event_id })` ved indsendelse, og din backend rapporterer det samme lead igen efter at have valideret det.

`event_id` identificerer én handling, ikke typen af handling. Hvert lead skal have sit eget. En værdi, der opfindes på afsendelsestidspunktet, er ny hver gang, så den forhindrer ingenting. Brug et ID, som dit system allerede har for netop den handling.

## Fejlfinding

**Hændelsen er gemt, men ikke tilskrevet en annonce.** Hændelsen indeholdt ingen `user.anonymous_id`, eller en værdi, som pixlen aldrig har brugt. De typiske årsager er, at cookien blev læst, før pixel-snippet'en kørte, at den blev læst på et domæne uden pixlen, eller at besøgende-ID'et blev gemt på den forkerte post. Bekræft rettelsen ved at vise hændelser for det besøgende-ID. Pixlens sidevisninger skal vises under det samme `identifier` som din hændelse.

**`400` med en meddelelse om `event_time`.** Tidsstemplet er mere end 28 dage gammelt. Send hændelsen tættere på, hvornår den sker, eller drop den.

**`400` på en `purchase`-hændelse.** `value` mangler eller er ikke større end nul. Annoncenetværk kan ikke optimere mod et salg uden beløb, så Whop afviser det.

**`401` eller `403`.** Nøglen mangler, mangler `event:create` eller tilhører en anden konto end `account_id`. Produktionsnøgler bruger `https://api.whop.com/api/v1`.


## Related topics

- [Start et projekt fra en blueprint](https://docs.whop.com/da/developer/guides/blueprints.md)
- [SendElement](https://docs.whop.com/da/elements/latest/wallet/send.md)
- [Migrer fra ældre fakturaer](https://docs.whop.com/da/developer/guides/migrate-from-legacy-invoices.md)
