Actions11
Overview
The "Meta Publisher" node enables publishing content to Instagram, Facebook Pages, and Threads platforms. Specifically for the Instagram resource with the "Publish Image (IG)" operation, this node allows users to publish an image post directly to an Instagram Business or Creator account.
This node is beneficial in scenarios such as:
- Automating social media marketing workflows by scheduling or triggering Instagram posts.
- Integrating content management systems or digital asset management tools with Instagram publishing.
- Streamlining multi-platform content distribution where Instagram is one of the target channels.
For example, a user can configure this node to take an image URL and caption from previous workflow steps and automatically publish it to their Instagram feed without manual intervention.
Properties
| Name | Meaning |
|---|---|
| Input Source | Choose where the node reads its parameters from: either directly from input fields ("Fields") or from a JSON property path inside the input item ("From JSON Property"). |
| JSON Property Path | Dot notation path inside the input JSON to extract parameters when "From JSON Property" is selected. Examples: $json, data, or payload.post. |
| Polling Interval (Sec) | Interval in seconds to check the processing status of the published post. Range: 1 to 60 seconds. |
| Max Wait (Sec) | Maximum time in seconds to wait before stopping the polling for post processing status. Range: 30 to 3600 seconds. |
| IG User ID | The Instagram User ID of the account where the image will be published. This is required. |
| Auto Publish (IG) | Boolean flag indicating whether to auto-publish the image immediately after upload (true) or not (false). Defaults to true. |
| Image URL | The publicly accessible URL of the image to be published on Instagram. This is required. |
| Caption | Optional text caption to accompany the image post on Instagram. |
Output
The node outputs JSON data representing the result of the publishing operation. This typically includes metadata about the published Instagram post such as post ID, status, and any relevant response details from the Instagram API.
If the operation involves asynchronous processing (e.g., waiting for the post to be fully processed), the node polls the status until completion or timeout based on the configured polling interval and max wait time.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for Meta's Graph API to authenticate requests.
- The Instagram account must be a Business or Creator account linked to a Facebook Page.
- Proper permissions/scopes must be granted to the API key to allow media publishing.
- Network access to the provided image URLs must be available for the API to fetch the media.
Troubleshooting
- Invalid IG User ID: If the Instagram User ID is incorrect or not linked properly, the node will fail to publish. Verify the ID corresponds to a valid Instagram Business/Creator account.
- Image URL inaccessible: The image URL must be publicly accessible. Private or expired URLs will cause errors.
- API permission errors: Ensure the API key has the necessary permissions to publish media on Instagram.
- Polling timeout: If the post processing takes longer than the configured max wait time, the node will stop polling and may return an incomplete status.
- Invalid JSON path: When using "From JSON Property" input source, ensure the JSON path correctly points to an object containing all required parameters.
Common error messages include:
"No JSON found at path ...": Indicates the specified JSON property path does not exist in the input."Invalid job payload (not an object)": The extracted data is not a valid object expected by the node."Unsupported IG operation in payload": The operation specified is not supported by the Instagram resource.
To resolve these, verify input data structure, credentials, and parameter correctness.