Posts

Añadir colaboradores a posts de Instagram con la API

Con instagram.collaborators, el post sale con otras cuentas invitadas como colaboradoras. Funciona en feed, reels y story, con la misma llamada POST /posts, sin app review.

La llamada

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

{
  "external_reference": "post-5120",
  "format": "feed",
  "caption": "Parceria nova",
  "media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/parceria.jpg"
    }
  ],
  "instagram": {
    "collaborators": [
      "marca_parceira",
      "criador_oficial"
    ]
  }
}

Qué puedes hacer

  • Invitar colaboradores en feed, reels y story.
  • Enviar los usernames sin @: Connect quita el @ inicial y usa minúsculas.
  • Combinar con etiquetas de usuario en media[].user_tags en los medios.
  • Usar cuentas instagram e instagram_business.

Reglas y límites

  • Máximo 5 colaboradores por post.
  • Cada username tiene hasta 30 caracteres: letras, números, punto y guion bajo, sin @.
  • En el story, collaborators es la única opción del bloque instagram.
  • La respuesta es 202: el post se publica en segundo plano. Síguelo con GET /posts/{uuid}.
  • external_reference es obligatorio e Idempotency-Key evita duplicar.

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.
mediaarraySíLista de medios, en orden. Cada ítem tiene type y url.
instagram.collaboratorsarrayNoHasta 5 usuarios invitados como colaboradores, sin @. Vale en feed, reels y story.
media.user_tagsarrayNoSolo Instagram. Etiquetas de usuario (username, x e y), hasta 20 por medio. En imagen, x e y de 0 a 1 van juntos.

Para quién

  • Posts de colaboración

    Marcas y creadores publican juntos: el SaaS envía el post desde la cuenta de la marca e invita al creador como colaborador.

  • Agencias

    La agencia publica desde la cuenta del cliente e invita a su propia cuenta como colaboradora.

  • Agente de IA de influencers

    Un agente arma el post de campaña e invita automáticamente a los perfiles de la lista de aliados.

Funciona con

  • Instagram Business
  • Instagram

Preguntas frecuentes

¿Cuántos colaboradores puedo invitar?

Hasta 5 por post, en feed, reels o story.

¿Debo enviar el @ en el username?

No. Envíalo sin @; si llega con @ inicial, se quita y el valor pasa a minúsculas.

¿Colaborador es lo mismo que etiquetar a un usuario?

No. Los colaboradores van en el bloque instagram; las etiquetas de usuario van en media[].user_tags.

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.