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

# Audiences API

> En Audience er en genanvendelig gruppe af personer, der skal inkluderes eller udelukkes ved målretning af annoncer.

Byg brugerdefinerede audiences ud fra kundelister eller Whop People-data, og opret lookalikes for at nå personer, der ligner en eksisterende audience.

Brug Audiences API'et til at oprette audiences, tilføje personer til en uploadet kundeliste, omdøbe eller ændre filtrene for en audience og overvåge asynkron behandling. Whop People-audiences kan opdateres automatisk eller bevare et øjebliksbillede.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [Vis Audiences](https://docs.whop.com/da/api-reference/audiences/list-audiences.md) | GET `/audiences` |
| [Opret Audience](https://docs.whop.com/da/api-reference/audiences/create-audience.md) | POST `/audiences` |
| [Tilføj personer](https://docs.whop.com/da/api-reference/audiences/add-people.md) | POST `/audiences/{id}/add_people` |
| [Opdater Audience](https://docs.whop.com/da/api-reference/audiences/update-audience.md) | PATCH `/audiences/{id}` |
| [Slet Audience](https://docs.whop.com/da/api-reference/audiences/delete-audience.md) | DELETE `/audiences/{id}` |

## Attributter

**id** `string` *required*

Audience-ID med præfikset `adaud_`.

**audience\_type** `string` *required*

Om audiencen målretter en defineret gruppe af personer eller personer, der ligner en eksisterende audience.

Tilgængelige muligheder: `custom`, `lookalike`

**auto\_refresh** `boolean` *required*

Om Whop genopbygger medlemskabet ud fra gemte People-filtre to gange om dagen. Når
den er `false`, beholder People-audiences de medlemmer, der matchede ved oprettelsen. Altid `false`
for uploadede lister, lookalikes og engagement-audiences.

**created\_at** `string` *required*

Hvornår audiencen blev oprettet, som et ISO 8601-tidsstempel.

**error\_message** `string | null` *required*

Hvorfor en `pending` audience ikke er startet, eller hvorfor en `partial` eller `failed`
ikke er fuldt bygget. `null`, når der ikke er noget at rapportere.

**filters** `object | null` *required*

Gemte Whop People-filtre, der definerer medlemskabet, med de samme nøgler som `GET
      	/people`. `null` for uploadede lister, engagement-audiences og lookalikes.

**last\_refreshed\_at** `string | null` *required*

Hvornår audiencens medlemskab sidst blev genopbygget, som et ISO 8601-tidsstempel.
`null`, indtil den første opbygning er fuldført.

**lookalike\_ratio** `number | null` *required*

For lookalikes: den øvre grænse for lighedsintervallet som en brøk (0.02 =
top 2%). `null` for brugerdefinerede audiences.

**lookalike\_starting\_ratio** `number | null` *required*

For lookalikes: den nedre grænse for lighedsintervallet som en brøk. `null`
for brugerdefinerede audiences og lookalikes på første niveau.

**match\_rates** `object[]` *required*

Estimerede matchrater pr. annoncenetværk. Tom for engagement-audiences og audiences, der ikke er sendt til et understøttet netværk.

> [accordion] Egenskaber
>
> **lower\_bound** `number | null` *required*
>
> Nedre grænse for den estimerede matchrate i procent. `null`, indtil den er tilgængelig.
>
> **platform** `string` *required*
>
> Den annonceplatform, der leverede matchrate-estimatet.
>
> Tilgængelige muligheder: `meta`
>
> **status** `string | null` *required*
>
> Tilgængeligheden af den estimerede matchrate.
>
> Tilgængelige muligheder: `calculating`, `available`, `unavailable`
>
> **upper\_bound** `number | null` *required*
>
> Øvre grænse for den estimerede matchrate i procent. `null`, indtil den er tilgængelig.

**matched\_rows** `number` *required*

Medlemmer, der er uploadet til tilknyttede annoncekonti. Altid 0 for
lookalikes og engagement-audiences.

**name** `string` *required*

Audiencens visningsnavn.

**platform\_audience\_ids** `string[]` *required*

Audience-ID'er på de annoncenetværk, Whop sender denne audience til.

**processed\_rows** `number` *required*

Medlemmer, der indtil videre er behandlet fra kilden. Altid 0 for lookalikes og
engagement-audiences.

**progress\_percent** `number` *required*

Behandlingsforløb fra 0 til 100.

**source\_audience\_id** `string | null` *required*

For lookalikes: den audience, denne lookalike er bygget ud fra. `null` for brugerdefinerede
audiences.

**source\_type** `string` *required*

Medlemskabskilde: en uploadet CSV, Whop People-filtre eller socialt engagement. Engagement-audiences kan ikke længere oprettes.

Tilgængelige muligheder: `csv_upload`, `people_filter`, `engagement`

**status** `string` *required*

Aktuel tilstand for oprettelsen af audiencen. Når en `pending` audience venter på noget, såsom en annoncekonto at uploade til, angiver `error_message` hvad. Når status er `partial` eller `failed`, forklarer `error_message`, hvad der gik galt.

Tilgængelige muligheder: `pending`, `processing`, `ready`, `partial`, `failed`

**total\_rows** `number` *required*

Samlet antal medlemmer fundet i kilden — CSV-rækker for uploadede lister, matchende
personer for automatiske audiences. Altid 0 for lookalikes og engagement-audiences.

**updated\_at** `string` *required*

Hvornår audiencen sidst blev opdateret, som et ISO 8601-tidsstempel.

```json Audience theme={null}
{
	"id": "adaud_PastPurchasers123",
	"name": "Past purchasers",
	"status": "ready",
	"audience_type": "custom",
	"source_type": "people_filter",
	"source_audience_id": null,
	"lookalike_ratio": null,
	"lookalike_starting_ratio": null,
	"total_rows": 2500,
	"processed_rows": 2500,
	"matched_rows": 1830,
	"progress_percent": 100,
	"error_message": null,
	"platform_audience_ids": ["120246230799130686"],
	"filters": {
		"has_purchased": true,
		"country": "US"
	},
	"auto_refresh": true,
	"last_refreshed_at": "2025-12-01T01:00:00Z",
	"match_rates": [
		{
			"platform": "meta",
			"status": "available",
			"lower_bound": 68.2,
			"upper_bound": 74.5
		}
	],
	"created_at": "2025-12-01T00:00:00Z",
	"updated_at": "2025-12-01T01:00:00Z"
}
```


## Related topics

- [Delete Audience](https://docs.whop.com/da/api-reference/audiences/delete-audience.md)
- [Update Audience](https://docs.whop.com/da/api-reference/audiences/update-audience.md)
- [Opret Audience](https://docs.whop.com/da/api-reference/audiences/create-audience.md)
