Meta Publisher icon

Meta Publisher

Publish to Instagram, Facebook Pages, and Threads

Actions11

Overview

The Meta Publisher node enables automated publishing of content to social media platforms owned by Meta, specifically Instagram, Facebook Pages, and Threads. It supports various types of posts such as images, videos, reels, stories, carousels, and text posts depending on the platform.

This node is beneficial for social media managers, marketers, or developers who want to automate content publishing workflows across multiple Meta platforms without manual intervention. For example, it can be used to schedule Instagram image posts with captions, publish Facebook Page videos with titles and descriptions, or post text updates and media on Threads.

Properties

Name Meaning
Input Source Choose where the node reads its parameters from: either directly from individual 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, payload.post.
Polling Interval (Sec) Interval in seconds to check the processing status of the published content. Range: 1 to 60 seconds.
Max Wait (Sec) Maximum time in seconds to wait before stopping polling for processing status. Range: 30 to 3600 seconds.

When Input Source = Fields, additional properties depend on the selected Resource and Operation:

  • Resource: Instagram

    • IG User ID: Instagram user identifier (required).
    • Auto Publish (IG): Boolean to auto-publish after upload.
    • Operations:
      • Publish Image: Media URL (required), Caption.
      • Publish Video: Media URL (required), Caption, Cover Image URL.
      • Publish Reel: Video URL (required), Caption, Thumbnail Offset (ms), Share to Feed (boolean).
      • Publish Story: Story Type (Image or Video), Media URL (required), Caption.
      • Publish Carousel: Items (multiple with type Image/Video and URL), Caption.

  • Resource: Facebook Page

    • Page ID: Facebook Page identifier (required).
    • Operations:
      • Publish Photo: Image URL (required), Caption.
      • Publish Video: Video URL (required), Title, Description.

  • Resource: Threads

    • Threads User ID: Threads user identifier (required).
    • Operations:
      • Publish Text: Text content.
      • Publish Image: Image URL (required), optional Text, Alt Text.
      • Publish Video: Video URL (required), optional Text, Alt Text.
      • Publish Carousel: Items (multiple with type Image/Video, URL, Alt Text), optional Text.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON contains the result of the publishing operation, which typically includes identifiers or URLs confirming successful publication.

If polling is enabled, the node waits and checks the processing status until completion or timeout, then returns the final status.

Binary data is not output by this node; all outputs are JSON metadata about the published content.

In case of errors, the output JSON will contain an error field describing the issue encountered for that item.

Dependencies

  • Requires an API authentication credential for Meta's Graph API to interact with Instagram, Facebook Pages, and Threads.
  • The node depends on internal helper functions (OPS) to perform specific publishing operations per platform and content type.
  • No external environment variables are explicitly required beyond the configured API credentials.

Troubleshooting

  • Invalid job payload (not an object): Occurs if the input JSON at the specified path is not an object or array of objects. Ensure the JSON property path points to valid structured data.
  • No JSON found at path: The specified JSON property path does not exist in the input item. Verify the path syntax and input data structure.
  • Unsupported resource or operation: If an unsupported resource or operation value is provided, the node throws an error. Confirm that the resource and operation names match supported options.
  • API errors: Errors from the Meta Graph API (e.g., invalid credentials, permission issues) will propagate as node errors. Check API keys and permissions.
  • Timeouts during polling: If the max wait time is too short, the node may stop polling before the content is fully processed. Increase the Max Wait parameter if needed.

To handle errors gracefully, enable "Continue On Fail" in the node settings to process subsequent items even if some fail.

Links and References

Discussion