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

CampoTipoObligatorioDescripción
external_referencestringSíEl id del post en tu sistema (hasta 100 caracteres). Evita publicar el mismo post dos veces en la misma cuenta.
formatstringSíFormato del post. En Instagram: feed, reels o story. En Facebook: feed, reels o story.
captionstringNoLeyenda. En Instagram, hasta 2200 caracteres, 30 hashtags y 20 menciones. Los stories no llevan leyenda.
mediaarraySíLista de medios, en orden. Cada ítem tiene type y url.
media.urlstringSíURL https:// pública que la red puede descargar (hasta 2048 caracteres).
instagram.share_to_feedbooleanNoSi el reel también aparece en la grilla del perfil. Solo en reels.
instagram.cover_urlstringNoURL https:// de la imagen de portada del reel. Solo en reels.
instagram.audio_idstringNoId 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.

Relacionadas

Ver todo lo que puedes hacer con Posts

Mira Connect aplicado a tu producto.

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