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

# API Ad Pixels

> Un Ad Pixel relie un pixel que vous possédez sur une plateforme publicitaire à une entreprise dont vous avez revendiqué les campagnes via le programme fournisseur pour annonceurs.

Whop envoie à ce pixel les conversions créditées à vos campagnes revendiquées pour cette entreprise, à l'aide du jeton d'accès que vous fournissez.

Utilisez l'API Ad Pixels pour ajouter un pixel par entreprise sur chaque plateforme publicitaire, lister ou récupérer vos pixels, remplacer un jeton d'accès rejeté par la plateforme publicitaire, et supprimer un pixel pour arrêter les envois.

## Endpoints

| Endpoint | Requête |
| - | - |
| [List ad pixels](https://docs.whop.com/fr/api-reference/ad-pixels/list-ad-pixels.md) | GET `/ad_pixels` |
| [Retrieve an ad pixel](https://docs.whop.com/fr/api-reference/ad-pixels/retrieve-an-ad-pixel.md) | GET `/ad_pixels/{id}` |
| [Create an ad pixel](https://docs.whop.com/fr/api-reference/ad-pixels/create-an-ad-pixel.md) | POST `/ad_pixels` |
| [Update an ad pixel](https://docs.whop.com/fr/api-reference/ad-pixels/update-an-ad-pixel.md) | PATCH `/ad_pixels/{id}` |
| [Delete an ad pixel](https://docs.whop.com/fr/api-reference/ad-pixels/delete-an-ad-pixel.md) | DELETE `/ad_pixels/{id}` |

## Attributs

**id** `string` *required*

ID du pixel publicitaire, préfixé par `adpx_`.

**account** `object` *required*

L'entreprise dont les campagnes revendiquées envoient des conversions à ce pixel, avec son nom et son logo.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte, préfixé par `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL de l'image du logo du compte. `null` lorsque le compte n'en a pas défini.
>
> **route** `string` *required*
>
> Identifiant de route public du compte, utilisé dans le chemin de la vitrine `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Nom d'affichage du compte.

**account\_id** `string` *required*

L'entreprise dont les campagnes revendiquées envoient des conversions à ce pixel, préfixée par `biz_`.

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

Date d'ajout du pixel, sous forme d'horodatage ISO 8601.

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

La raison pour laquelle la plateforme publicitaire a rejeté le dernier envoi. Null sauf si `status` vaut `errored`.

**external\_id** `string` *required*

L'ID du pixel sur la plateforme publicitaire : un ID de pixel ou de dataset Meta, un code de pixel TikTok, un ID client Google Ads ou un ID de tag Thrad.

**name** `string | null` *required*

Le nom du pixel sur la plateforme publicitaire. Null lorsque la plateforme publicitaire n'en a renvoyé aucun.

**platform** `string` *required*

La plateforme publicitaire à laquelle appartient le pixel.

Options disponibles : `meta`, `tiktok`, `google`, `thrad`

**status** `string` *required*

`active` reçoit les conversions. `errored` s'est arrêté parce que la plateforme publicitaire a rejeté le jeton d'accès ; mettez à jour le jeton pour reprendre. `disabled` a été désactivé par Whop.

Options disponibles : `active`, `errored`, `disabled`

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

Date de dernière modification du pixel, sous forme d'horodatage ISO 8601.

```json AdPixel theme={null}
{
	"id": "adpx_Kp7mQ2vXr9sTb",
	"account_id": "biz_7cRtUq3LmPx9Wd",
	"account": {
		"id": "biz_7cRtUq3LmPx9Wd",
		"title": "Acme Studio",
		"route": "acme-studio",
		"logo_url": "https://img.whop.com/acme-studio-logo.png"
	},
	"platform": "meta",
	"external_id": "1823877485451638",
	"name": null,
	"status": "active",
	"error_message": null,
	"created_at": "2026-10-09T18:24:31.512Z",
	"updated_at": "2026-10-09T18:24:31.512Z"
}
```


## Related topics

- [Update an Ad Pixel](https://docs.whop.com/fr/api-reference/ad-pixels/update-an-ad-pixel.md)
- [Create an Ad Pixel](https://docs.whop.com/fr/api-reference/ad-pixels/create-an-ad-pixel.md)
- [Delete an Ad Pixel](https://docs.whop.com/fr/api-reference/ad-pixels/delete-an-ad-pixel.md)
