> ## 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 de Ad Pixels

> Un Ad Pixel conecta un píxel que posees en una plataforma de anuncios con un negocio cuyas campañas reclamaste a través del programa de proveedores de anunciantes.

Whop envía a ese píxel las conversiones atribuidas a tus campañas reclamadas para ese negocio, usando el token de acceso que proporcionas.

Usa la API de Ad Pixels para añadir un píxel por negocio en cada plataforma de anuncios, listar u obtener tus píxeles, reemplazar un token de acceso que la plataforma de anuncios rechazó y eliminar un píxel para detener los envíos.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar ad pixels](https://docs.whop.com/es/api-reference/ad-pixels/list-ad-pixels.md) | GET `/ad_pixels` |
| [Obtener un ad pixel](https://docs.whop.com/es/api-reference/ad-pixels/retrieve-an-ad-pixel.md) | GET `/ad_pixels/{id}` |
| [Crear un ad pixel](https://docs.whop.com/es/api-reference/ad-pixels/create-an-ad-pixel.md) | POST `/ad_pixels` |
| [Actualizar un ad pixel](https://docs.whop.com/es/api-reference/ad-pixels/update-an-ad-pixel.md) | PATCH `/ad_pixels/{id}` |
| [Eliminar un ad pixel](https://docs.whop.com/es/api-reference/ad-pixels/delete-an-ad-pixel.md) | DELETE `/ad_pixels/{id}` |

## Atributos

**id** `string` *required*

ID del ad pixel, con el prefijo `adpx_`.

**account** `object` *required*

El negocio cuyas campañas reclamadas envían conversiones a este píxel, con su nombre y logo.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta, con el prefijo `biz_`.
>
> **logo\_url** `string | null` *required*
>
> URL de la imagen del logo de la cuenta. `null` cuando la cuenta no ha establecido uno.
>
> **route** `string` *required*
>
> Identificador de ruta pública de la cuenta, usado en la ruta de la tienda
> `whop.com/\{route}`.
>
> **title** `string` *required*
>
> Nombre visible de la cuenta.

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

El negocio cuyas campañas reclamadas envían conversiones a este píxel, con el
prefijo `biz_`.

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

Cuándo se añadió el píxel, como marca de tiempo ISO 8601.

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

Por qué la plataforma de anuncios rechazó el último envío. Null salvo que
`status` sea `errored`.

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

El ID del píxel en la plataforma de anuncios: un ID de píxel o de dataset de
Meta, un código de píxel de TikTok, un ID de cliente de Google Ads o un ID de
etiqueta de Thrad.

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

El nombre del píxel en la plataforma de anuncios. Null cuando la plataforma de anuncios no devolvió ninguno.

**platform** `string` *required*

La plataforma de anuncios a la que pertenece el píxel.

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

**status** `string` *required*

`active` recibe conversiones. `errored` se detuvo porque la plataforma de anuncios rechazó el token de acceso; actualiza el token para reanudar. `disabled` fue desactivado por Whop.

Opciones disponibles: `active`, `errored`, `disabled`

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

Cuándo se modificó el píxel por última vez, como marca de tiempo 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

- [API de Ad Campaigns](https://docs.whop.com/es/api-reference/ad-campaigns/ad-campaign.md)
- [API de Ad Groups](https://docs.whop.com/es/api-reference/ad-groups/ad-group.md)
- [Update an Ad Pixel](https://docs.whop.com/es/api-reference/ad-pixels/update-an-ad-pixel.md)
