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

# CampaignCreatorElement

> El creador de campañas publicitarias: objetivo y presupuesto, grupos de anuncios con su segmentación y su programación, y los propios anuncios con sus creatividades; todo el flujo hasta el lanzamiento. Se abre vacío para crear una nueva campaña, o sobre una existente cuando pasas `campaignId`. También ejecuta el comprobador del píxel: un lanzamiento requiere que el evento de conversión del grupo de anuncios esté activo en la URL de destino, y el asistente `pixel-setup` se abre dentro de este elemento para corregir una instalación que falta. Un lanzamiento también requiere que la cuenta haya firmado el acuerdo de Whop Ads: si no lo ha hecho, el handle abre `ads-agreement` sobre el creador y el lanzamiento continúa una vez firmado. Los presupuestos se introducen y se muestran en la `ads_reporting_currency` de la cuenta (la moneda que ya usan sus informes) y se convierten y facturan en USD al tipo de cambio actual. El único token que estableces en el handle `ads` debe incluir los scopes del píxel junto con los scopes de campaña (`ad_campaign:create` y `company:basic:read`), en lugar de usar un token distinto para cada elemento.

> [!NOTE]
>
> Esta página documenta `@whop/elements@1.10.0` y `@whop/elements-react@1.10.0`.

*Desde `v1.0.0`.*

Se abre como modal desde [`Ads`](https://docs.whop.com/es/elements/latest/ads/overview): `ads.createOverlay('campaign-creator')`. Pasa las props y los callbacks en las opciones de creación.

> [!NOTE]
>
> Este elemento es **solo modal**. Ábrelo con `createOverlay`; no tiene montaje en línea.

```tsx React theme={null}
import { WhopElements, Ads, CampaignCreatorElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <CampaignCreatorElement onExited={(e) => console.log(e)} onLaunched={(e) => console.log(e)} />
      </Ads>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const ads = window.WhopElements().ads.create({ /* options */ });
  ads.createOverlay('campaign-creator', {
    onExited: (e) => console.log(e),
    onLaunched: (e) => console.log(e)
  }).open();
</script>
```

Datos de ejemplo. [Abre el Playground](https://docs.whop.com/es/elements/latest/ads/overview#playground).

## Props

**campaignId** `string`

La campaña (`adcamp_…`) que se abre. Si está vacío, se crea una nueva. Un borrador se abre donde se dejó; una campaña lanzada se abre en modo de edición. Por defecto es `""`.

**adGroupId** `string`

El grupo de anuncios (`adgrp_…`) que se abre enfocado, dentro de `campaignId`. Se ignora cuando la campaña no tiene ese grupo y cuando `campaignId` está vacío. Por defecto es `""`.

**adId** `string`

El anuncio (`ad_…`) que se abre enfocado, dentro de `adGroupId`. Se ignora cuando ese grupo no tiene ese anuncio y cuando `adGroupId` está vacío. Por defecto es `""`.

**initialStep** `"ads" | "ad-groups" | "campaign-settings"`

En qué paso se abre: `campaign-settings`, `ad-groups` o `ads`. El panel enlaza directamente a esto desde su propia URL; pásalo para llevar al propietario de la cuenta directamente a la parte que quiere cambiar. Se lee una vez al montar: cambiarlo después no lo llevará de un paso a otro. Por defecto es `"campaign-settings"`.

**externalMediaIds** `string[]`

ID de archivos (`file_…`) que tu app subió mediante `POST /api/v1/files`, ofrecidos en la biblioteca de creatividades del creador. Aparecen primero en la lista de la biblioteca, en este orden, y mientras haya alguno establecido los selectores de medios se abren en la biblioteca en lugar de en la zona para soltar archivos. Crea los archivos con la misma clave de API que genera el `accessToken` del handle `ads`: el creador los lee en un solo lote (`GET /api/v1/files`), y las lecturas de archivos solo responden a la credencial que los creó. Pasa como máximo 250 ID, el límite de la lectura por lotes. Un archivo aparece cuando su subida termina de procesarse; un ID que nunca termina, o que apunta a algo que no es una imagen ni un vídeo, se omite. Pasa nuevos ID con `update({ externalMediaIds })` para enviar medios a un creador que ya está abierto. Por defecto es `[]`.

## Eventos

Pasa los callbacks en las opciones de creación o como props de React.

### `onExited`

El propietario de la cuenta salió del creador sin lanzar. No se ha descartado nada: si se empezó una campaña en borrador, ya está guardada. Cuando se emite este evento, el overlay ya se ha cerrado solo; reacciona a él si tu página lo necesita.

### `onLaunched`

Una campaña se activó. `firstLaunch` marca la primera campaña lanzada de la cuenta, que es lo que usa el panel para mostrar su estado de bienvenida. El overlay ya se ha cerrado solo; aquí es donde rediriges al siguiente paso.

**payload** `object`

**propiedades**

**campaignId** `string` *required*

**firstLaunch** `boolean` *required*

### `onLoaderStart`

Se ejecuta después de que el esqueleto de carga se pinta por primera vez y antes de `onReady`.

### `onReady`

Se ejecuta después del primer pintado completo del elemento.

### `onError`

Se ejecuta cuando el elemento no se carga o falla. El contenido de respaldo permanece visible. Usa `code` para el manejo programático. `sourceKey` identifica una fuente de estado del host que falló.

**e** `object`

**propiedades**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Métodos

Llámalos en el handle que devuelve `create`, o a través de una `ref` de React.

### `mount`

Monta el elemento en `target` y comienza a cargarlo. Los componentes de React se montan solos.

**Parámetros**

**target** `string | HTMLElement` *required*

### `destroy`

Elimina el elemento y libera su frame y sus suscripciones. Puedes llamarlo más de una vez. React elimina el elemento automáticamente.

### `update`

Combina nuevas props en el elemento montado. En React, cambia las props del componente en su lugar.

**Parámetros**

**options** `Partial\<CampaignCreatorElementProps\>` *required*

## Estilos

Aplica estilo a estas partes mediante `appearance.classes`. Usa camel case o kebab case para los nombres de las propiedades e incluye las unidades. Las hojas de estilo de la página no pueden llegar al frame del elemento. El framework valida cada declaración antes de inyectarla.

| Clase | Aplica a |
| - | - |
| `.whop-PixelSetupSurface` | La raíz del asistente de configuración del píxel: un paso cada vez |

```ts theme={null}
const ads = whop.ads.create({
  appearance: {
    classes: {
      'whop-PixelSetupSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

ads.update({
  appearance: {
    classes: { 'whop-PixelSetupSurface': { fontWeight: '700' } }
  }
});
```

En React, pasa `appearance` a `<Ads>`. Establécelo globalmente con `WhopElements({ appearance })`.
