Actions11
Overview
This node, named "Meta Publisher," enables publishing content to Instagram, Facebook Pages, and Threads. Specifically for the Instagram resource with the "Publish Story (IG)" operation, it allows users to publish stories directly to an Instagram account. The story can be either an image or a video, accompanied optionally by a caption.
Common scenarios where this node is beneficial include:
- Automating Instagram story posting as part of a social media marketing workflow.
- Scheduling stories with dynamic media URLs and captions sourced from previous nodes or external data.
- Integrating Instagram story publishing into broader automation pipelines that manage multiple social platforms.
Practical example:
- A marketing team uses this node to automatically post daily promotional stories on Instagram using images or videos generated or selected earlier in the workflow, with captions customized per campaign.
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 (whole JSON), data, or payload.post. |
| Polling Interval (Sec) | Interval in seconds to check the processing status of the published story. Range: 1 to 60 seconds. |
| Max Wait (Sec) | Maximum time in seconds to wait before stopping polling for the story's processing status. Range: 30 to 3600 seconds. |
| IG User ID | Instagram user ID where the story will be published. This is required. |
| Auto Publish (IG) | Boolean flag indicating whether to auto-publish the story immediately after upload (true) or not (false). Defaults to true. |
| Story Type | Type of story media to publish: either "Image" or "Video". |
| Media URL | URL of the media file (image or video) to be published as the story. Required. |
| Caption | Optional text caption to accompany the story. |
Output
The node outputs JSON data representing the result of the publishing operation. This typically includes metadata about the published story such as IDs, status, or any response returned by the Meta API.
If the story is successfully published, the output JSON confirms the publication details. If there is an error, the output JSON contains an error message describing the issue.
The node does not output binary data for this operation; all outputs are JSON structured.
Dependencies
- Requires an API key credential for authenticating with the Meta Graph API.
- The node depends on the Meta Graph API service to perform publishing actions.
- Proper permissions/scopes must be granted to the API key to allow story publishing on the specified Instagram user account.
- Network connectivity to Meta's API endpoints is necessary.
Troubleshooting
Common issues:
- Invalid or missing Instagram User ID will cause failures.
- Incorrect or inaccessible Media URL may lead to upload errors.
- Insufficient API permissions or expired tokens can cause authorization errors.
- Polling timeout if the story processing takes longer than the configured max wait time.
Error messages and resolutions:
"No JSON found at path ...": When using JSON input source, ensure the JSON path is correct and the data exists."Invalid job payload (not an object)": The extracted JSON data must be an object; arrays or primitives are invalid."Unsupported IG operation in payload": Ensure the operation is set to "publishStory" for Instagram stories.- API errors related to authentication or permissions require checking the API key credentials and scopes.
- Timeout errors suggest increasing the "Max Wait (Sec)" parameter or verifying network/API responsiveness.