Posts
Publicar reels en Instagram con la API
Con format reels y un video en media, Connect publica un reel en la cuenta de Instagram que tu cliente conectó. Una sola llamada sirve para todas las cuentas, sin app review y sin guardar tokens.
La llamada
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "reel-310",
"format": "reels",
"caption": "Bastidores da campanha #reels",
"media": [
{
"type": "video",
"url": "https://cdn.example.com/reel.mp4"
}
],
"instagram": {
"share_to_feed": true,
"cover_url": "https://cdn.example.com/capa.jpg",
"first_comment": "Qual parte você mais gostou?"
}
}Qué puedes hacer
- Publicar un reel desde una URL de video https:// pública.
- Elegir una imagen de portada con instagram.cover_url.
- Decidir si el reel también aparece en la grilla del perfil con instagram.share_to_feed.
- Usar un audio de Instagram con audio_id y ajustar audio_volume y video_volume.
- Añadir colaboradores, ubicación, primer comentario y desactivar comentarios.
Reglas y límites
- Reels acepta exactamente 1 video.
- La leyenda llega hasta 2200 caracteres, con máximo 30 hashtags y 20 menciones.
- share_to_feed vale true por defecto.
- audio_volume y video_volume exigen audio_id.
- La respuesta es 202: la publicación corre en segundo plano y la sigues con GET /posts/{uuid}.
- external_reference es obligatorio (409 si ya existe una publicación igual) e Idempotency-Key, de hasta 255 caracteres, devuelve el post ya guardado con 200 en el replay.
Campos principales
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| external_reference | string | Sí | El id del post en tu sistema (hasta 100 caracteres). Evita publicar el mismo post dos veces en la misma cuenta. |
| format | string | Sí | Formato del post. En Instagram: feed, reels o story. En Facebook: feed, reels o story. |
| caption | string | No | Leyenda. En Instagram, hasta 2200 caracteres, 30 hashtags y 20 menciones. Los stories no llevan leyenda. |
| media | array | Sí | Lista de medios, en orden. Cada ítem tiene type y url. |
| media.url | string | Sí | URL https:// pública que la red puede descargar (hasta 2048 caracteres). |
| instagram.share_to_feed | boolean | No | Si el reel también aparece en la grilla del perfil. Solo en reels. |
| instagram.cover_url | string | No | URL https:// de la imagen de portada del reel. Solo en reels. |
| instagram.audio_id | string | No | Id de un audio de Instagram para el reel. Solo en reels. |
Para quién
Herramienta de video corto
Tu editor exporta el video y publica el reel directo en la cuenta del usuario, con portada y leyenda definidas al instante.
Agencia con muchos clientes
Un solo flujo publica el mismo reel en decenas de cuentas de Instagram conectadas, cada una con su customer_integration.
Agente de IA de redes sociales
Un agente genera el video, elige la portada y publica el reel, con el primer comentario ya listo.
Funciona con
Instagram Business
Instagram
Preguntas frecuentes
¿Puedo publicar un video solo como feed?
No. Un video solo debe ir como reels; feed es para 1 imagen o un carrusel de 2 a 10 medios.
¿El reel aparece en la grilla del perfil?
Por defecto sí, porque share_to_feed vale true. Envía instagram.share_to_feed como false para que no aparezca.
¿Funciona con cuentas instagram e instagram_business?
Sí. Las dos conexiones aceptan el mismo POST /posts y el mismo bloque instagram.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
