---
title: "Anuncios en grupo"
method: POST
path: "/api/v1/compose_group"
tags: ["General"]
---

# Anuncios en grupo

`POST /api/v1/compose_group`

## Request

- Base URL: `https://api.pymaia.com`
- URL: `https://api.pymaia.com/api/v1/compose_group`
- Auth: HTTP bearer

Anuncios en grupo. modo → piezas · recompone si parece IA · nativa · dedupe · cobro: produccion (default) 1·no·no·—·4; exploracion 3·gratis·no·titular y familia·4+2+2; campana ≤12 persona×ángulo×formato (presupuesto de prueba)·pago·desde 3·imagen y anuncios vivos·cotizado; iterar = campana sobre anuncio_origen, sin dedupe contra él. Sin cotizacion_id cotiza gratis; acepto_costo_creditos:true sólo si la persona aceptó el total.

## Request body

- object
  - `modo` 'produccion' | 'exploracion' | 'campana' | 'iterar'
  - `cotizacion_id` string, uuid
  - `acepto_costo_creditos` boolean
  - `variantes` integer
  - `anuncio_origen` string
  - `presupuesto_diario` number
  - `piezas` object[]
    - `label` string
    - `template_slug` string
    - `headline` string, required
    - `subheadline` string
    - `cta` string
    - `badge` string
    - `bullets` string[]
  - `format` 'feed' | 'portrait' | 'story'
  - `evidencia` string[]

## Response `200`

Tool executed successfully

- object
  - `ok` boolean
  - `result` unknown
  - `duration_ms` number

## Other responses

- `400`: Invalid params or handler error
- `401`: Missing or invalid Bearer token
- `403`: Missing required scope(s) (`denied_scope`), or the tool's module is disabled for the organization (`module_disabled`, with `why`, `fix` and `module`)
- `404`: Tool not found, internal-only, or excluded for OAuth connectors
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/pymaia/apis/pymaia-api.md) · [All operations](https://skmtc.dev/pymaia/apis/pymaia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pymaia/apis/pymaia-api/revisions/705a6973177b?raw)