N8N Tools - Instagram Enhanced icon

N8N Tools - Instagram Enhanced

Complete Instagram Graph API integration with media management, insights, stories, reels, shopping, and advanced features

Overview

The node integrates with Instagram's Graph API to manage media posts, specifically supporting the creation of carousel posts under the "Media" resource and "Create Carousel" operation. This operation allows users to create a carousel post on Instagram by specifying multiple existing media items (photos or videos) as carousel children, along with an optional caption and location.

This node is beneficial for social media managers, marketers, or automation specialists who want to programmatically publish multi-photo/video posts (carousels) on Instagram without manual intervention. For example, a brand could automate posting product showcases or event highlights as carousels directly from their content management system.

Properties

Name Meaning
Caption Text caption for the carousel post. Supports multiline input.
Hashtags List of hashtags to include in the caption. Each hashtag is specified without the "#" sign.
Location ID Optional Instagram location identifier to tag the post with a specific place.
Media IDs Required list of Instagram media IDs representing each item (photo/video) in the carousel.

Output

  • The output JSON contains the response from the Instagram API after creating the carousel container.
  • Typically, this includes identifiers and metadata about the created carousel container.
  • The node does not output binary data for this operation.

Dependencies

  • Requires an active subscription and valid API key for the external service referred to as "N8N Tools API" for validation.
  • Needs Instagram OAuth2 credentials configured in n8n to authenticate requests to Instagram Graph API.
  • The node internally uses helper classes to interact with Instagram endpoints for media management.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws errors related to invalid subscription or API key, verify that the API key credential is correctly set up and active.
  • Missing or Incorrect Media IDs: The carousel creation requires valid Instagram media IDs for each carousel item. Ensure these IDs are correct and correspond to media already uploaded to Instagram.
  • Caption Formatting Issues: Hashtags are formatted and appended to the caption automatically. Improper formatting might cause unexpected caption text.
  • API Rate Limits: Instagram API enforces rate limits; hitting these may cause temporary failures.
  • Permission Errors: Ensure the Instagram account has permissions to create carousel posts via the API.

Links and References


If you need details on other operations or resources, feel free to ask!

Discussion