Actions11
Overview
This node, named "Meta Publisher," enables publishing media content specifically to Threads (a social media platform by Meta). The "Publish Image (Threads)" operation allows users to post an image to a Threads user account, optionally accompanied by text and alt text for accessibility.
Typical use cases include:
- Automating the posting of images to Threads accounts as part of a social media management workflow.
- Integrating image publishing into larger automation pipelines that manage multiple social platforms.
- Adding descriptive alt text to images for improved accessibility compliance.
For example, a marketing team could use this node to automatically publish product images with descriptions to their Threads account whenever new products are added to their catalog.
Properties
| Name | Meaning |
|---|---|
| Input Source | Choose where the node reads its parameters from: either directly from input fields or from a JSON property path inside the input item. |
| JSON Property Path | Dot notation path inside the input JSON to extract parameters when "From JSON Property" is selected as Input Source. Examples: $json, data, or payload.post. |
| Polling Interval (Sec) | How often (in seconds) the node checks the processing status after submitting the post. Range: 1 to 60 seconds. Default is 2 seconds. |
| Max Wait (Sec) | Maximum time (in seconds) to wait for the post processing before stopping polling. Range: 30 to 3600 seconds. Default is 300 seconds. |
| Threads User ID | The unique identifier of the Threads user account where the image will be published. Required field. |
| Image URL | The URL of the image to be published on Threads. Required field. |
| Text (Optional) | Optional text caption or message to accompany the image post. |
| Alt Text | Alternative text description for the image to improve accessibility. |
Output
The node outputs JSON data representing the result of the publishing operation. This typically includes metadata about the posted image, confirmation of successful publication, or error details if the operation failed.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for Meta's Graph API configured in n8n to authenticate requests.
- Internet access to reach Meta's Threads API endpoints.
- Properly set Threads User ID corresponding to the target account.
Troubleshooting
Common Issues:
- Invalid or missing Threads User ID will cause the operation to fail.
- Incorrect or inaccessible Image URL may result in errors during upload.
- Network issues or invalid API credentials can prevent successful publishing.
- If using JSON input source, incorrect JSON path or malformed JSON will cause errors.
Error Messages:
"No JSON found at path ..."indicates the specified JSON property path does not exist in the input."Invalid job payload (not an object)"means the extracted data is not a valid object expected by the node."Unsupported Threads operation in payload: ..."suggests an invalid operation was requested.
Resolutions:
- Verify the Threads User ID is correct and has permissions to post.
- Ensure the Image URL is publicly accessible and points to a valid image file.
- Check the JSON property path matches the structure of your input data.
- Confirm API credentials are correctly configured and have necessary scopes.