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 carousel posts on an Instagram Business Account. A carousel post is a single post containing multiple media items (images or videos) that users can swipe through.

Common scenarios where this node is beneficial include:

  • Social media managers automating the posting of multi-image or multi-video Instagram carousels.
  • Marketing automation workflows that publish product showcases or event highlights as carousel posts.
  • Content scheduling systems that batch upload multiple media items in one post.

Practical example: You have a set of product images and videos you want to share as a single Instagram carousel post with a caption describing the collection. This node lets you specify the Instagram Business Account ID, provide URLs for each media item, and optionally add a caption, then publishes the carousel post automatically.

Properties

Name Meaning
Instagram Business Account ID The unique identifier of the Instagram Business Account where the carousel post will be published.
Media Items A list of media items to include in the carousel. Each item requires:
- Media Type: Choose between "Image" or "Video".
- Media URL: The direct URL to the media file (image or video).
Carousel Caption Optional text caption to accompany the entire carousel post.

Output

The node outputs JSON data representing the response from the Instagram Graph API after publishing the carousel post. The key fields typically include:

  • id: The unique identifier of the created carousel post.
  • Other metadata returned by the API about the published media.

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to access the Facebook/Instagram Graph API.
  • The Instagram Business Account must be linked and authorized via the connected Facebook app.
  • Network access to the Instagram Graph API endpoint (https://graph.facebook.com/v23.0).

Troubleshooting

  • Common issues:

    • Invalid or missing Instagram Business Account ID.
    • Media URLs not accessible or invalid format.
    • Insufficient permissions or expired API credentials.
    • Exceeding Instagram API rate limits.

  • Error messages:

    • Errors from the API are caught and reported with details such as error type, message, and code.
    • Example: "Facebook/Instagram/Threads API Error: OAuthException: Invalid OAuth access token."

  • Resolutions:

    • Verify the Instagram Business Account ID is correct and linked properly.
    • Ensure media URLs are publicly accessible and correctly formatted.
    • Refresh or reconfigure API authentication credentials.
    • Check API usage limits and wait or request higher quota if needed.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion