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

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íSiempre feed en Threads.
captionstringNoEl texto del post, hasta 500 caracteres. Obligatorio cuando no hay medios.
mediaarrayNoHasta 20 imágenes o videos, en orden. Puede omitirse para un post solo de texto.
threads.reply_controlstringNoQuién puede responder: everyone, accounts_you_follow, mentioned_only, parent_post_author_only o followers_only.
threads.link_attachmentstringNoEnlace con vista previa adjunto al post. Solo en un post sin medios.
threads.topic_tagstringNoEtiqueta de tema, hasta 50 caracteres, sin puntos ni &.
threads.first_commentstringNoRespuesta 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.

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.