Meta PublisherInstall

Summary

Create an image post on Threads using an image URL, optionally with accompanying text, alt text, and a topic tag. The node polls the container’s processing status, publishes it when ready, then attempts to retrieve its permalink.

Inputs

• Input Source — Choose Fields (the default) to configure values in the node, or From JSON Property to read one or more job objects from an input item’s JSON.
• JSON Property Path — When using From JSON Property, the dot path to the job object or array; defaults to the whole input JSON ($json). Jobs use the Threads resource and operation fields, plus the parameters below.
• Threads User ID (required) — Threads user ID to publish from. In JSON mode, provide as thUserId or userId.
• Image URL (required) — URL of the image to post. In JSON mode, use imageUrl.
• Text (Optional) — Optional text to accompany the image. In JSON mode, use text.
• Alt Text — Optional alternative text for the image. In JSON mode, use altText.
• Topic Tag — Optional topic tag, up to 50 characters. In JSON mode, use topicTag.
• Polling Interval (Sec) — How often to check image processing status; defaults to 5 seconds (UI range 1–60). In JSON mode, use pollSec.
• Max Wait (Sec) — Maximum time to poll before stopping; defaults to 300 seconds (UI range 30–3600). In JSON mode, use maxWaitSec.

Output shape

A single output item per job, containing a JSON result object.

The result includes id (threads-image), platform, type, creationId, processing status, published, publishResult, and permalink. Publishing occurs when the status is FINISHED or PUBLISHED; if polling stops without either status, the result can indicate published: false and omit the publish result and permalink. A publish or permalink lookup error can fail the node.

Links

• n8n community nodes installation guide