Actions11
Overview
This node, named "Meta Publisher," enables publishing content to Instagram, Facebook Pages, and Threads platforms. Specifically for the Instagram resource with the "Publish Carousel (IG)" operation, it allows users to publish a carousel post consisting of multiple images and/or videos in a single post.
Common scenarios where this node is beneficial include:
- Social media managers automating the posting of multi-media carousel posts on Instagram.
- Marketing teams scheduling and publishing rich content carousels without manual intervention.
- Content creators who want to batch upload multiple images/videos as a single Instagram post programmatically.
Practical example:
- A user wants to publish a carousel post on Instagram containing 3 images and 2 videos with a caption describing the collection. This node can take URLs of these media items and publish them as one carousel post automatically.
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 read parameters from when "From JSON Property" is selected. For example, "$json" to use the whole JSON, or "data" to use $json.data. |
| Polling Interval (Sec) | How often (in seconds) the node checks the processing status of the published content. Minimum 1 second, maximum 60 seconds. |
| Max Wait (Sec) | Maximum time (in seconds) to wait for the publishing process before stopping polling. Minimum 30 seconds, maximum 3600 seconds (1 hour). |
| IG User ID | The Instagram User ID under which the carousel post will be published. This is required. |
| Auto Publish (IG) | Boolean flag indicating whether to auto-publish the carousel immediately after uploading or not. |
| Items | Collection of media items to include in the carousel. Each item requires: - Type: "Image" or "Video". - URL: Direct URL to the media file. Multiple items can be added. |
| Caption | Text caption to accompany the carousel post on Instagram. |
Output
The node outputs JSON data representing the result of the publish operation. This typically includes metadata about the published carousel post such as IDs, status, and any relevant response data from the Instagram API.
If the node supports binary data output (not explicitly shown here), it would represent media files or thumbnails related to the published content. However, for this operation, the output is primarily JSON metadata confirming the successful publication or error details.
Dependencies
- Requires an API key credential for Meta's Graph API to authenticate requests.
- Needs proper configuration of Instagram Business Account linked to a Facebook Page.
- The node depends on the Meta Graph API service endpoints to perform publishing actions.
- Network access to Instagram's API endpoints is necessary.
- The user must provide valid Instagram User ID and media URLs accessible by Instagram servers.
Troubleshooting
Common Issues:
- Invalid or inaccessible media URLs may cause publishing failures.
- Incorrect Instagram User ID or lack of permissions can lead to authorization errors.
- Exceeding max wait time without completion might indicate API delays or issues.
- Using incorrect JSON property paths when selecting "From JSON Property" input source can cause missing parameter errors.
Error Messages:
"No JSON found at path \"<path>\"": Indicates the specified JSON path does not exist in the input data. Verify the path correctness."Invalid job payload (not an object)": The extracted data from JSON is not an object as expected. Ensure the input data structure matches requirements."Unsupported IG operation in payload: <operation>": The operation requested is not supported by the node. Confirm you are using "publishCarousel" for this resource.- Authorization or permission errors from the API usually require checking credentials and Instagram account setup.
Resolutions:
- Double-check all input parameters, especially media URLs and user IDs.
- Ensure the API credentials have the necessary scopes and permissions.
- Validate JSON paths if using JSON input source.
- Increase polling interval or max wait time if API responses are slow.