Posts
Publicar en Threads con la API
Un POST /posts con format feed publica en la cuenta de Threads que el cliente conectó. No implementas el OAuth de Threads ni guardas tokens: envías el contenido y Connect publica en segundo plano. El mismo endpoint sirve para las otras redes.
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": "We shipped v2 of the dashboard. What do you want to see in v3?",
"threads": {
"reply_control": "accounts_you_follow",
"topic_tag": "saas",
"first_comment": "Full changelog on our site."
}
}Qué puedes hacer
- Publicar texto puro, con un pie de hasta 500 caracteres.
- Publicar hasta 20 imágenes o videos en un solo post.
- Definir quién puede responder con reply_control.
- Adjuntar un enlace con vista previa a un post de texto con link_attachment.
- Marcar el post con un topic_tag y publicar un first_comment justo después.
Reglas y límites
- En Threads solo existe el format feed. Necesita pie o medios.
- link_attachment solo vale en un post sin medios. topic_tag no acepta puntos ni &.
- POST /posts responde 202 y la publicación corre después. Síguela con GET /posts/{uuid}.
- external_reference es obligatoria. Enviar de nuevo la misma referencia en la misma cuenta, mientras publica o ya publicada, devuelve 409.
- El header Idempotency-Key (hasta 255 caracteres) devuelve el post ya guardado si se repite la misma solicitud.
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í | Siempre feed en Threads. |
| caption | string | No | El texto del post, hasta 500 caracteres. Obligatorio cuando no hay medios. |
| media | array | No | Hasta 20 imágenes o videos, en orden. Puede omitirse para un post solo de texto. |
| threads.reply_control | string | No | Quién puede responder: everyone, accounts_you_follow, mentioned_only, parent_post_author_only o followers_only. |
| threads.link_attachment | string | No | Enlace con vista previa adjunto al post. Solo en un post sin medios. |
| threads.topic_tag | string | No | Etiqueta de tema, hasta 50 caracteres, sin puntos ni &. |
| threads.first_comment | string | No | Respuesta publicada por la propia cuenta justo después del post, hasta 500 caracteres. |
Para quién
Herramienta de redes sociales
Tu producto de programación envía el post a Threads junto con Instagram y LinkedIn, por el mismo endpoint.
Agente de IA que publica
Un agente redacta el texto y lo publica en el Threads del cliente, eligiendo reply_control para limitar las respuestas.
CRM con contenido
Un CRM publica novedades de sus clientes en Threads y usa first_comment para poner el enlace justo debajo.
Funciona con
Threads
Preguntas frecuentes
¿Puedo publicar solo texto en Threads?
Sí. Envía format feed y caption, sin media. El pie llega hasta 500 caracteres.
¿Cuántos medios caben en un post de Threads?
Hasta 20 imágenes o videos en un post.
¿Cómo sé si el post salió?
POST /posts responde 202 con el post en created. Consulta GET /posts/{uuid} hasta que status sea published o failed.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
