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

> Una Ad Campaign es el contenedor de nivel superior de los anuncios pagados. Define el objetivo y la estrategia de presupuesto que comparten sus grupos de anuncios y anuncios.

Una Ad Campaign es el contenedor de nivel superior de los anuncios pagados. Define el objetivo y la estrategia de presupuesto que comparten sus [grupos de anuncios](https://docs.whop.com/es/api-reference/ad-groups/ad-group) y anuncios.

Usa la API de Ad Campaigns para crear campañas, listar las campañas de una cuenta, obtener o actualizar la configuración de una campaña y pausar o reanudar la entrega de la campaña.

La facturación de anuncios combina el gasto elegible de todas las campañas de la cuenta. Un pago fallido bloquea la entrega con `delivery_status: payment_failed` y conserva el `status` activo/en pausa configurado. Corrige el método de pago de la cuenta y [reintenta su pago de anuncios](https://docs.whop.com/es/api-reference/accounts/retry-failed-ads-payments.md) una vez para la cuenta. El reintento es asíncrono: que se acepte no confirma el pago. Una liquidación exitosa elimina el bloqueo; las campañas activas pueden reanudarse si por lo demás son elegibles, mientras que las campañas en pausa siguen en pausa. Consulta [facturación y reintentos](https://docs.whop.com/es/developer/ads/overview.md#paying-for-ads).

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Ad Campaigns](https://docs.whop.com/es/api-reference/ad-campaigns/list-ad-campaigns.md) | GET `/ad_campaigns` |
| [Obtener una Ad Campaign](https://docs.whop.com/es/api-reference/ad-campaigns/retrieve-an-ad-campaign.md) | GET `/ad_campaigns/{id}` |
| [Crear una Ad Campaign](https://docs.whop.com/es/api-reference/ad-campaigns/create-an-ad-campaign.md) | POST `/ad_campaigns` |
| [Duplicar una Ad Campaign](https://docs.whop.com/es/api-reference/ad-campaigns/duplicate-an-ad-campaign.md) | POST `/ad_campaigns/{id}/duplicate` |
| [Pausar una Ad Campaign](https://docs.whop.com/es/api-reference/ad-campaigns/pause-an-ad-campaign.md) | POST `/ad_campaigns/{id}/pause` |
| [Reintentar un pago fallido de Ad Campaign](https://docs.whop.com/es/api-reference/ad-campaigns/retry-a-failed-ad-campaign-payment.md) | POST `/ad_campaigns/{id}/retry_payment` |
| [Reanudar una Ad Campaign](https://docs.whop.com/es/api-reference/ad-campaigns/unpause-an-ad-campaign.md) | POST `/ad_campaigns/{id}/unpause` |
| [Actualizar una Ad Campaign](https://docs.whop.com/es/api-reference/ad-campaigns/update-an-ad-campaign.md) | PATCH `/ad_campaigns/{id}` |
| [Eliminar una Ad Campaign](https://docs.whop.com/es/api-reference/ad-campaigns/delete-an-ad-campaign.md) | DELETE `/ad_campaigns/{id}` |

## Atributos

**id** `string` *required*

Identificador único de la campaña publicitaria, con el prefijo `adcamp_`.

**account** `object | null` *required*

El negocio que ejecuta esta campaña, con el nombre y el logo que muestran sus anuncios.

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

**added\_to\_cart\_value** `number` *required*

Valor en USD atribuido a los eventos de añadir al carrito. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**added\_to\_carts** `number` *required*

Eventos de añadir al carrito atribuidos por el píxel de Whop, último clic.

**budget\_amount** `number | null` *required*

El presupuesto de la campaña en USD, la moneda en la que se almacena y se factura. `null` cuando cada grupo de anuncios establece su propio presupuesto.

**budget\_amount\_local** `number | null` *required*

El mismo presupuesto expresado en `budget_currency` al tipo de cambio de hoy, para mostrarlo en la moneda de informes de anuncios de la cuenta. `null` cuando `budget_amount` lo es.

**budget\_currency** `string` *required*

El código ISO 4217 en el que está `budget_amount_local`: la preferencia `ads_reporting_currency` de la cuenta. `usd` a menos que la cuenta la haya cambiado.

**budget\_optimization** `string | null` *required*

Qué nivel posee el presupuesto: toda la campaña (`ad_campaign`) o cada grupo de anuncios por separado (`ad_group`).

Opciones disponibles: `ad_campaign`, `ad_group`

**budget\_type** `string | null` *required*

Si `budget_amount` se gasta por día (`daily`) o durante toda la duración de la campaña (`lifetime`).

Opciones disponibles: `daily`, `lifetime`

**campaign\_type** `string` *required*

El tipo de campaña, fijado al crearla. `standard` ejecuta anuncios de imagen y video; `search` muestra anuncios de texto en los resultados de búsqueda para las palabras clave de los grupos de anuncios.

Opciones disponibles: `standard`, `search`

**click\_through\_rate** `number` *required*

Clics divididos entre impresiones, entre 0 y 1.

**clicks** `number` *required*

El número de clics.

**completed\_registration\_value** `number` *required*

Valor en USD atribuido a los eventos de registro completado. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**completed\_registrations** `number` *required*

Eventos de registro completado atribuidos por el píxel de Whop, último clic.

**contact\_value** `number` *required*

Valor en USD atribuido a los eventos de contacto. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**contacts** `number` *required*

Eventos de contacto atribuidos por el píxel de Whop, último clic.

**cost\_per\_added\_to\_cart** `number | null` *required*

Gasto dividido entre los eventos de añadir al carrito atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**cost\_per\_click** `number` *required*

Gasto dividido entre clics; 0 cuando no hay clics.

**cost\_per\_completed\_registration** `number | null` *required*

Gasto dividido entre los eventos de registro completado atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**cost\_per\_contact** `number | null` *required*

Gasto dividido entre los eventos de contacto atribuidos; null cuando los contactos no son el objetivo y no hay ninguno atribuido.

**cost\_per\_lead** `number | null` *required*

Gasto dividido entre los leads atribuidos; null cuando los leads no son un objetivo y no hay ninguno atribuido.

**cost\_per\_mille** `number` *required*

Gasto por cada 1.000 impresiones; 0 cuando no hay impresiones.

**cost\_per\_purchase** `number | null` *required*

Gasto dividido entre las compras atribuidas; null cuando las compras no son un objetivo y no hay ninguna atribuida.

**cost\_per\_result** `number | null` *required*

Gasto dividido entre los resultados atribuidos por el píxel de Whop; null cuando no se está optimizando para nada atribuible por Whop.

**cost\_per\_schedule** `number | null` *required*

Gasto dividido entre los eventos de agendamiento atribuidos; null cuando los agendamientos no son el objetivo y no hay ninguno atribuido.

**cost\_per\_submitted\_application** `number | null` *required*

Gasto dividido entre los eventos de envío de solicitud atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

**cost\_per\_unique\_click** `number | null` *required*

Gasto dividido entre clics únicos; null cuando no hay clics únicos.

**cost\_per\_viewed\_content** `number | null` *required*

Gasto dividido entre los eventos de visualización de contenido atribuidos; null cuando no son el objetivo y no hay ninguno atribuido.

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

Cuándo se creó la campaña, como marca de tiempo ISO 8601.

**custom\_conversions** `number` *required*

Eventos de conversión personalizados (definidos por el comerciante) atribuidos por el píxel de Whop, último clic, en todos los nombres de eventos personalizados.

**custom\_event\_counts** `object` *required*

Conversiones personalizadas atribuidas por el píxel de Whop, indexadas por el nombre de tu evento, con su recuento de último clic como valor. Vacío cuando no hay eventos personalizados con nombre atribuidos. Los eventos personalizados disparados sin nombre se cuentan en custom\_conversions pero se omiten aquí, por lo que estos valores suman como máximo custom\_conversions.

**custom\_event\_values** `object` *required*

Valor de conversión atribuido a cada evento personalizado, indexado por nombre de evento como custom\_event\_counts. Suma el valor pasado a whop.track, normalizado a USD; los eventos disparados sin valor aportan 0.

**delivery\_status** `string` *required*

Si los anuncios de la campaña se están entregando ahora mismo y, si no, por qué. La revisión de contenido es in\_review; una campaña que espera para empezar es processing. Los fallos de facturación de la cuenta establecen payment\_failed sin cambiar el estado configurado. Un reintento de pago exitoso elimina ese bloqueo y recalcula la entrega. Cuando se aplican varios estados a la vez, se devuelve el de mayor precedencia.

Opciones disponibles: `payment_failed`, `all_ads_rejected`, `draft`, `paused`, `in_review`, `learning`, `processing`, `revise_content`, `issues`, `scheduled`, `completed`, `active`

**desired\_cost\_per\_result** `number | null`

El costo por resultado, en USD, que el anunciante quiere que logre esta campaña. Solo es un objetivo: no es una puja, un límite de costo ni un límite de puja, y no cambia cómo pujan los anuncios de la campaña. `null` cuando no hay objetivo establecido.

**ends\_at** `string | null` *required*

Cuándo deja de entregarse la campaña, como marca de tiempo ISO 8601. `null` cuando se ejecuta hasta que se pausa, o cuando sus grupos de anuncios establecen su propia programación.

**frequency** `number | null` *required*

Impresiones divididas entre el alcance.

**impressions** `number` *required*

El número de impresiones.

**issues** `object[]` *required*

Problemas abiertos que afectan a la campaña y a sus grupos de anuncios y anuncios descendientes.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> Identificador único del problema.
>
> **category** `string` *required*
>
> El tipo de problema: información sobre la entrega, una advertencia o un error que requiere atención.
>
> Opciones disponibles: `information`, `warning`, `error`
>
> **message** `string` *required*
>
> Una descripción de en qué consiste el problema y cómo puede resolverse.
>
> **resource\_id** `string | null` *required*
>
> El ID de la campaña, el grupo de anuncios o el anuncio al que está asociado el problema.
>
> **resource\_type** `string` *required*
>
> El tipo de recurso al que está asociado el problema.
>
> Opciones disponibles: `ad_campaign`, `ad_group`, `ad`
>
> **title** `string` *required*
>
> Un título breve del problema, orientado al creador: la regla que indica un rechazo de la revisión de contenido, o una etiqueta genérica.

**lead\_value** `number` *required*

Valor en USD atribuido a los eventos de lead. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**leads** `number` *required*

Leads atribuidos por el píxel de Whop, último clic.

**link\_clicks** `number` *required*

Vistas de página en tu destino de personas que hicieron clic en el anuncio, registradas por el píxel de Whop. Se cuentan de la misma forma en todas las plataformas de anuncios.

**objective** `string | null` *required*

El objetivo hacia el que optimiza la campaña. `awareness` solo aparece en campañas creadas antes de que se retirara; esas campañas no se pueden lanzar.

Opciones disponibles: `awareness`, `traffic`, `engagement`, `leads`, `sales`

**purchase\_value** `number` *required*

Valor en USD de las compras atribuidas por el píxel.

**purchases** `number` *required*

Compras atribuidas por el píxel de Whop, último clic.

**reach** `number` *required*

El número de personas únicas que vieron esto.

**result\_event** `string | null` *required*

El evento de conversión del píxel de Whop cuyo recuento atribuido representa los resultados: el objetivo de optimización, o el evento atribuido de mayor volumen en las campañas con presupuesto por grupo de anuncios. Null cuando el objetivo no es un evento atribuido por Whop.

Opciones disponibles: `purchase`, `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `custom`, `messaging_conversation`

**result\_event\_name** `string | null` *required*

El nombre del evento definido por el comerciante cuando result\_event es custom; null para los eventos estándar.

**results** `number | null` *required*

El recuento atribuido por el píxel de Whop detrás de result\_event. Cuando los grupos de anuncios de una campaña optimizan objetivos distintos no hay un único result\_event (es null), y esto es en cambio la suma de los resultados atribuidos de cada grupo de anuncios. Null cuando no se está optimizando para nada atribuible por Whop.

**return\_on\_ad\_spend** `number` *required*

Valor de compra dividido entre el gasto, ambos en USD (una proporción independiente de la moneda); 0 cuando no hay gasto.

**schedule\_value** `number` *required*

Valor en USD atribuido a los eventos de agendamiento. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**schedules** `number` *required*

Eventos de agendamiento atribuidos por el píxel de Whop, último clic.

**special\_ad\_categories** `string[]` *required*

Categorías reguladas bajo las que se declara la campaña. Los anuncios de estas categorías están sujetos a restricciones de segmentación adicionales. Vacío cuando no se aplica ninguna.

Opciones disponibles: `housing`, `employment`, `financial_products`, `politics`

**spend** `number` *required*

El importe cobrado, en spend\_currency.

**spend\_currency** `string | null` *required*

El código de moneda ISO 4217 de todas las métricas monetarias.

**starts\_at** `string | null` *required*

Cuándo empieza a entregarse la campaña, como marca de tiempo ISO 8601. `null` cuando empieza en cuanto se lanza, o cuando sus grupos de anuncios establecen su propia programación.

**status** `string` *required*

El estado del ciclo de vida configurado de la campaña publicitaria. Los fallos de facturación conservan aquí active o paused y establecen delivery\_status en payment\_failed.

Opciones disponibles: `active`, `paused`, `inactive`, `payment_failed`, `draft`, `duplicating`

**submitted\_application\_value** `number` *required*

Valor en USD atribuido a los eventos de envío de solicitud. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**submitted\_applications** `number` *required*

Eventos de envío de solicitud atribuidos por el píxel de Whop, último clic.

**target\_cost\_per\_result** `number | null` *required*

El costo por resultado deseado para `target_result_event`, en USD. `null` cuando no se ha establecido ninguno.

**target\_result\_event** `string | null` *required*

El evento por el que se calcula `target_cost_per_result`, como `purchase` o `lead`. `null` cuando la campaña no tiene un único objetivo.

**title** `string` *required*

Nombre visible de la campaña publicitaria.

**unique\_click\_through\_rate** `number | null` *required*

Clics únicos divididos entre impresiones, entre 0 y 1.

**unique\_clicks** `number` *required*

Personas que hicieron clic, informadas por el píxel de Whop, contadas una vez por persona.

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

Cuándo se actualizó la campaña por última vez, como marca de tiempo ISO 8601.

**viewed\_content\_value** `number` *required*

Valor en USD atribuido a los eventos de visualización de contenido. Suma el valor enviado con cada evento, normalizado a USD; los eventos sin valor aportan 0.

**viewed\_contents** `number` *required*

Eventos de visualización de contenido atribuidos por el píxel de Whop, último clic.

```json AdCampaign theme={null}
{
	"id": "adcamp_xxxxxxxxxx",
	"account": {
		"id": "biz_xxxxxxxxxxxxx",
		"title": "Acme Studio",
		"route": "acme-studio",
		"logo_url": "https://img.whop.com/acme-studio-logo.png"
	},
	"added_to_cart_value": 2100,
	"added_to_carts": 42,
	"budget_amount": 250,
	"budget_amount_local": 250,
	"budget_currency": "usd",
	"budget_optimization": "ad_campaign",
	"budget_type": "daily",
	"campaign_type": "standard",
	"click_through_rate": 0.032,
	"clicks": 1200,
	"completed_registration_value": 0,
	"completed_registrations": 28,
	"contact_value": 0,
	"contacts": 18,
	"cost_per_added_to_cart": 17.86,
	"cost_per_click": 0.63,
	"cost_per_completed_registration": 26.79,
	"cost_per_contact": 41.67,
	"cost_per_lead": 30,
	"cost_per_mille": 20,
	"cost_per_purchase": 50,
	"cost_per_result": 50,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.74,
	"cost_per_viewed_content": 1.25,
	"created_at": "2026-06-01T12:00:00Z",
	"custom_conversions": 10,
	"custom_event_counts": {
		"QualifiedCall": 7,
		"BookedDemo": 3
	},
	"custom_event_values": {
		"QualifiedCall": 3500,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"ends_at": null,
	"frequency": 2.1,
	"impressions": 37500,
	"issues": [
		{
			"id": "adiss_xxxxxxxxxxx",
			"category": "error",
			"title": "Ad issue",
			"message": "The ad's creative violates the ad network's policies. Edit the creative and resubmit for review.",
			"resource_id": "adcamp_xxxxxxxxxx",
			"resource_type": "ad_campaign"
		}
	],
	"lead_value": 1250,
	"leads": 25,
	"link_clicks": 960,
	"objective": "sales",
	"purchase_value": 12600,
	"purchases": 15,
	"reach": 17800,
	"result_event": "purchase",
	"result_event_name": null,
	"results": 15,
	"return_on_ad_spend": 16.8,
	"schedule_value": 0,
	"schedules": 0,
	"special_ad_categories": [],
	"spend": 750,
	"spend_currency": "usd",
	"starts_at": null,
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"target_cost_per_result": 12.5,
	"target_result_event": "purchase",
	"title": "Pickaxe Pro launch",
	"unique_click_through_rate": 0.027,
	"unique_clicks": 1010,
	"updated_at": "2026-06-02T12:00:00Z",
	"viewed_content_value": 0,
	"viewed_contents": 600
}
```


## Related topics

- [API de Ad Groups](https://docs.whop.com/es/api-reference/ad-groups/ad-group.md)
- [API de Ad Pixels](https://docs.whop.com/es/api-reference/ad-pixels/ad-pixel.md)
- [Delete an Ad Campaign](https://docs.whop.com/es/api-reference/ad-campaigns/delete-an-ad-campaign.md)
