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
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| name | string | Sí | Nombre del anuncio, y de los niveles creados que no tengan uno. |
| status | string | No | Estado final del árbol (active o paused). Todo nace pausado y se activa en el último paso. |
| campaign | object | No | {"id": ...} para una campaña existente; sin id, describe la que se creará. |
| adset | object | Sí | {"id": ...} para un conjunto existente; sin id, describe el que se creará (presupuesto, público, optimización). |
| ad.post_id | string | Sí | El post a impulsar, de GET /ads/facebook_ads/posts. |
| ad.facebook_ads.instagram_account_id | string | Sí | La cuenta de Instagram dueña del post. La propiedad del post se prueba por ella. |
| ad.link_url | string | No | URL de destino, cuando aplica. |
| ad.call_to_action | string | No | Botó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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
