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

> Een Audience is een herbruikbare groep personen die je kunt opnemen of uitsluiten bij het targeten van advertenties.

Bouw aangepaste doelgroepen op basis van klantenlijsten of Whop People-gegevens, en maak lookalikes om personen te bereiken die lijken op een bestaande doelgroep.

Gebruik de Audiences API om doelgroepen aan te maken, personen toe te voegen aan een geüploade klantenlijst, een doelgroep te hernoemen of opnieuw te filteren en de asynchrone verwerking te volgen. Whop People-doelgroepen kunnen automatisch worden vernieuwd of een momentopname behouden.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Audiences opvragen](https://docs.whop.com/nl/api-reference/audiences/list-audiences.md) | GET `/audiences` |
| [Audience aanmaken](https://docs.whop.com/nl/api-reference/audiences/create-audience.md) | POST `/audiences` |
| [Personen toevoegen](https://docs.whop.com/nl/api-reference/audiences/add-people.md) | POST `/audiences/{id}/add_people` |
| [Audience bijwerken](https://docs.whop.com/nl/api-reference/audiences/update-audience.md) | PATCH `/audiences/{id}` |
| [Audience verwijderen](https://docs.whop.com/nl/api-reference/audiences/delete-audience.md) | DELETE `/audiences/{id}` |

## Attributen

**id** `string` *required*

Audience-ID, met prefix `adaud_`.

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

Of de doelgroep zich richt op een gedefinieerde groep personen of op personen die lijken op een bestaande doelgroep.

Beschikbare opties: `custom`, `lookalike`

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

Of Whop het lidmaatschap twee keer per dag opnieuw opbouwt op basis van opgeslagen People-filters. Wanneer `false`, behouden People-doelgroepen de leden die bij het aanmaken overeenkwamen. Altijd `false` voor geüploade lijsten, lookalikes en engagementdoelgroepen.

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

Wanneer de doelgroep is aangemaakt, als ISO 8601-tijdstempel.

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

Waarom een `pending`-doelgroep nog niet is gestart, of waarom een `partial`- of `failed`-doelgroep niet volledig is opgebouwd. `null` wanneer er niets te melden is.

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

Opgeslagen Whop People-filters die het lidmaatschap bepalen, met dezelfde sleutels als `GET /people`. `null` voor geüploade lijsten, engagementdoelgroepen en lookalikes.

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

Wanneer het lidmaatschap van de doelgroep voor het laatst opnieuw is opgebouwd, als ISO 8601-tijdstempel. `null` totdat de eerste opbouw is voltooid.

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

Voor lookalikes: de bovengrens van de gelijkenisband als fractie (0.02 = top 2%). `null` voor aangepaste doelgroepen.

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

Voor lookalikes: de ondergrens van de gelijkenisband als fractie. `null` voor aangepaste doelgroepen en lookalikes van het eerste niveau.

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

Geschatte matchpercentages per advertentienetwerk. Leeg voor engagementdoelgroepen en doelgroepen die niet naar een ondersteund netwerk worden gestuurd.

> [accordion] Eigenschappen
>
> **lower\_bound** `number | null` *required*
>
> Ondergrens van het geschatte matchpercentage. `null` totdat beschikbaar.
>
> **platform** `string` *required*
>
> Het advertentieplatform dat de schatting van het matchpercentage heeft geleverd.
>
> Beschikbare opties: `meta`
>
> **status** `string | null` *required*
>
> Beschikbaarheid van het geschatte matchpercentage.
>
> Beschikbare opties: `calculating`, `available`, `unavailable`
>
> **upper\_bound** `number | null` *required*
>
> Bovengrens van het geschatte matchpercentage. `null` totdat beschikbaar.

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

Leden die succesvol zijn geüpload naar gekoppelde advertentieaccounts. Altijd 0 voor lookalikes en engagementdoelgroepen.

**name** `string` *required*

Weergavenaam van de doelgroep.

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

Doelgroep-ID's op de advertentienetwerken waarnaar Whop deze doelgroep stuurt.

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

Leden die tot nu toe uit de bron zijn verwerkt. Altijd 0 voor lookalikes en engagementdoelgroepen.

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

Verwerkingsvoortgang van 0 tot 100.

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

Voor lookalikes: de doelgroep op basis waarvan deze lookalike is opgebouwd. `null` voor aangepaste doelgroepen.

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

Bron van het lidmaatschap: een geüploade CSV, Whop People-filters of social engagement. Engagementdoelgroepen kunnen niet langer worden aangemaakt.

Beschikbare opties: `csv_upload`, `people_filter`, `engagement`

**status** `string` *required*

Huidige status van het aanmaken van de doelgroep. Wanneer een `pending`-doelgroep op iets wacht, zoals een advertentieaccount om naar te uploaden, geeft `error_message` aan waarop. Wanneer de status `partial` of `failed` is, legt `error_message` uit wat er misging.

Beschikbare opties: `pending`, `processing`, `ready`, `partial`, `failed`

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

Totaal aantal leden dat in de bron is gedetecteerd — CSV-rijen voor geüploade lijsten, overeenkomende personen voor automatische doelgroepen. Altijd 0 voor lookalikes en engagementdoelgroepen.

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

Wanneer de doelgroep voor het laatst is bijgewerkt, als ISO 8601-tijdstempel.

```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/nl/api-reference/audiences/delete-audience.md)
- [Update Audience](https://docs.whop.com/nl/api-reference/audiences/update-audience.md)
- [Audience aanmaken](https://docs.whop.com/nl/api-reference/audiences/create-audience.md)
