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
| 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. |
| media | array | Sí | Lista de medios, en orden. Cada ítem tiene type y url. |
| instagram.collaborators | array | No | Hasta 5 usuarios invitados como colaboradores, sin @. Vale en feed, reels y story. |
| media.user_tags | array | No | Solo 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
