Ads

Impulsar un post de Instagram por API con la API

POST /ads/boost convierte un post ya publicado en anuncio, en la cuenta que el cliente conectó. Es el mismo árbol de POST /ads (campaña, conjunto y anuncio), pero el creativo viene del post: textos y media no forman parte del impulso. No implementas la API de Meta ni pasas por revisión de app.

La llamada

POST /api/ads/boost?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "name": "Impulsionar post",
  "status": "active",
  "campaign": {
    "facebook_ads": {
      "objective": "engagement"
    }
  },
  "adset": {
    "budget": {
      "amount": 20,
      "type": "daily"
    },
    "targeting": {
      "countries": [
        "BR"
      ]
    },
    "facebook_ads": {
      "optimization_goal": "post_engagement",
      "billing_event": "impressions"
    }
  },
  "ad": {
    "post_id": "18191649508387596",
    "facebook_ads": {
      "instagram_account_id": "17841442920331135"
    }
  }
}

Qué puedes hacer

  • Listar los posts que se pueden impulsar en GET /ads/facebook_ads/posts.
  • Impulsar un post creando campaña y conjunto nuevos, o reutilizando existentes con {"id": ...}.
  • Definir presupuesto, país, optimización y facturación del conjunto.
  • Pedir status active para activar en el último paso.
  • Enviar link_url y call_to_action opcionales.

Reglas y límites

  • Todo se crea pausado y el status pedido se aplica en el último paso.
  • Idempotency-Key es obligatorio en el header; repetir con la misma clave devuelve 200 con Idempotent-Replay: true.
  • ad.post_id sale de GET /ads/facebook_ads/posts. Sin el parámetro source, la lista trae media de Instagram, la única que sirve para impulsar; con source=facebook la lista sirve solo para descubrimiento.
  • facebook_ads.instagram_account_id es obligatorio: por él se prueba la propiedad del post.
  • El creativo de un anuncio impulsado no se puede cambiar después: 422 boosted_creative_not_replaceable.
  • Si un paso falla, lo creado se deshace y repetir con la misma clave retoma. La respuesta es síncrona (201).

Campos principales

CampoTipoObligatorioDescripción
namestringSíNombre del anuncio, y de los niveles creados que no tengan uno.
statusstringNoEstado final del árbol (active o paused). Todo nace pausado y se activa en el último paso.
campaignobjectNo{"id": ...} para una campaña existente; sin id, describe la que se creará.
adsetobjectSí{"id": ...} para un conjunto existente; sin id, describe el que se creará (presupuesto, público, optimización).
ad.post_idstringSíEl post a impulsar, de GET /ads/facebook_ads/posts.
ad.facebook_ads.instagram_account_idstringSíLa cuenta de Instagram dueña del post. La propiedad del post se prueba por ella.
ad.link_urlstringNoURL de destino, cuando aplica.
ad.call_to_actionstringNoBotón del anuncio. Valores en GET /ads/options.

Para quién

  • Botón Impulsar en tu producto

    Muestra los posts del cliente y, con un clic, crea el impulso con el presupuesto y el público elegidos.

  • Automatización para posts de buen rendimiento

    Cuando un post supera un umbral de engagement en tus métricas, crea el impulso automáticamente, pausado, para aprobación.

  • Agente de IA de redes sociales

    El agente elige el post, propone presupuesto y público y lo crea pausado para que el gestor lo apruebe.

Funciona con

  • Meta Ads

Preguntas frecuentes

¿Puedo impulsar posts de Facebook?

La lista de posts de Facebook (source=facebook) sirve para descubrimiento, no para impulsar. El impulso usa media de Instagram.

¿Puedo cambiar el texto o la imagen del anuncio impulsado?

No. El creativo viene del post, y cambiarlo responde 422 boosted_creative_not_replaceable.

¿El impulso empieza a gastar enseguida?

Solo si envías status active. Todo nace pausado y la activación es el último paso.

Relacionadas

Ver todo lo que puedes hacer con Ads

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.