Facebook, Instagram & Threads icon

Facebook, Instagram & Threads

Create and publish content to Facebook, Instagram, and Threads
Join our community

Actions12

Overview

This node enables creating and publishing content to Instagram, specifically supporting the creation of Instagram Stories in this context. It interacts with the Instagram Graph API to upload media (images or videos) as stories on an Instagram Business Account.

Typical use cases include:

  • Automatically posting promotional images or videos as Instagram Stories.
  • Sharing time-sensitive updates or announcements via Instagram Stories.
  • Integrating Instagram Story posting into broader marketing automation workflows.

For example, a user can provide a URL to an image or video and specify its type, then the node uploads and publishes it as a story on the specified Instagram Business Account.

Properties

Name Meaning
Instagram Business Account ID The unique identifier of the Instagram Business Account where the story will be posted.
Story Media URL The URL pointing to the image or video file to be used in the story.
Story Media Type The type of media being uploaded; options are: Image or Video.

Output

The node outputs JSON data representing the response from the Instagram Graph API after publishing the story. This typically includes identifiers such as the creation_id confirming successful upload and publication.

No binary data output is produced by this operation.

Example output JSON structure (simplified):

{
  "id": "12345678901234567"
}

Where id is the identifier of the published story media.

Dependencies

  • Requires an API authentication token credential configured in n8n for accessing the Facebook/Instagram Graph API.
  • The Instagram Business Account must be linked and authorized for the API calls.
  • Network access to https://graph.facebook.com/v23.0 is required.

Troubleshooting

  • Common issues:

    • Invalid or missing Instagram Business Account ID.
    • Incorrect or inaccessible media URL.
    • Insufficient permissions or expired API credentials.
    • Media type mismatch (e.g., specifying video but providing an image URL).

  • Error messages:

    • Errors returned from the API include detailed error types and messages, e.g., permission errors or invalid parameters.
    • The node surfaces these errors with descriptive messages like Facebook/Instagram/Threads API Error: <error message>.

  • Resolution tips:

    • Verify that the Instagram Business Account ID is correct and linked properly.
    • Ensure the media URL is publicly accessible and points directly to the media file.
    • Confirm that the API credentials have the necessary permissions and are valid.
    • Match the media type property correctly with the actual media content.

Links and References

Discussion