@mookielianhd/n8n-nodes-instagram

This package’s Instagram nodes for n8n let you publish and manage content, moderate comments, send DMs, and react to real-time events (comments, messages, mentions, story insights, etc.) on Instagram Business and Creator accounts via the Facebook/Instagram Graph API.

All functionality is built on the Facebook/Instagram Graph API, including media publishing (images, Reels, Stories, carousels), comment moderation, private replies, messaging, hashtag search, IG User/Page helpers, and webhook-based triggers for Business and Creator accounts.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

The node exposes several resources:

Credentials

Create an Instagram API credential that stores a long-lived Facebook Graph API user access token with at least:

• instagram_basic
• pages_show_list
• instagram_content_publish
• pages_read_engagement
• instagram_manage_comments (or instagram_business_manage_comments if using Instagram Login)
  Steps:

1. Make sure the Instagram account is a Business/Creator account connected to a Facebook Page.
2. Use Meta’s Graph Explorer or your own app to generate an access token that includes the scopes listed above.
3. Convert it to a long-lived token and paste it into the credential’s Access Token field.
4. The built-in credential test hits https://graph.facebook.com/v22.0/me to confirm the token works.

Instagram Webhook Trigger credentials

For the Instagram Trigger node you need a separate Instagram Webhook credential that stores your Meta App Secret (from App Dashboard → Settings → Basic). The App Secret is used to verify the X-Hub-Signature-256 header on incoming webhook POSTs from Meta. The Verify Token is set in the node parameters (see below) and must match the value you enter in the Meta App Dashboard when configuring the webhook URL.

Instagram Webhook Trigger

This package’s Instagram nodes for n8n let you publish and manage content, moderate comments, send DMs, and react to real-time events (comments, messages, mentions, story insights, etc.) on Instagram Business and Creator accounts via the Facebook/Instagram Graph API.

The Instagram Trigger node listens for real-time webhook events from Meta and starts a workflow when an event is received.

Setup

1. Create the credential
   Add an Instagram Webhook credential and enter your Meta App Secret (from your app’s Settings → Basic in the Meta App Dashboard).

2. Add the trigger to your workflow
   Add the Instagram Trigger node. Set Verify Token to any string you will use in the Meta Dashboard (e.g. a random secret). Copy the Webhook URL shown in the node (Production or Test URL).

3. Configure Webhooks in Meta App Dashboard

   • In Meta for Developers, open your app and go to Webhooks (or add the Webhooks product).
   • For Instagram, set:
     • Callback URL: paste the n8n Webhook URL from the trigger node.
     • Verify Token: the same string you set in the node’s Verify Token parameter.
   • Subscribe to the Instagram fields you need (e.g. comments, messages, mentions, story_insights).
   • Save. Meta will send a GET request to your URL; the node responds with the challenge so verification succeeds.

4. Optional: filter events
   Use Events to Include on the node to pass only selected event types (e.g. only messages and mentions) to the workflow. If left empty, all received events are output.

Each event is output as an item with object, field, value, id, time and the raw change payload, so you can use the Instagram node (e.g. Messaging, Comments) in the same workflow to reply or moderate. To return a custom response to the caller instead of the default 200 OK, add a Respond to Webhook node after the trigger.

Compatibility

• Built and tested against n8n 2.6.x–2.8.x.
• Declares a peer dependency on n8n-workflow >=2.6.1 (the first secure stream-enabled version suggested by Snyk).
• Requires n8n with community nodes enabled (recommended >=2.x).
• Uses only built-in n8n dependencies, so it is Cloud-compatible.

Usage

Publishing media (Image / Reels / Stories)

1. Add the Instagram node to your workflow and select one of the resources (Image / Reels / Stories).
2. Provide the Instagram Business Account ID (the Node parameter), media URL and caption.
3. The node first creates the media container, polls Graph API until processing completes, then triggers media_publish.
4. For long-running uploads (large videos), the node uses robust polling and retry logic and surfaces progress via the n8n execution logs (for example, when publishing Reels or Trial Reels).
5. Handle any errors returned by the API (rate limits, permissions, validation) via the node’s error output or Continue On Fail.

Publishing carousel posts (Carousel)

1. Add the Instagram node and set Resource to Carousel, Operation to Publish.
2. Provide:
   • Node – the IG User ID to publish from.
   • Graph API Version – for example v24.0.
   • Caption – the carousel caption.
   • Carousel Media – 2–10 items, each with:
     • Media Type – Image or Video.
     • Image URL or Video URL – public URLs Meta can fetch.
3. The node:
   • Creates one child container per image/video (is_carousel_item=true for each).
   • Waits for each child container to become ready.
   • Creates a carousel container (media_type=CAROUSEL, children=<child_ids>) with the caption.
   • Waits for the carousel container to be ready, then calls /{ig-user-id}/media_publish.
4. Errors during any step are annotated with which child item failed (for example, “Carousel item 3 (video)…”), making it easier to debug problematic URLs.

Comment moderation and private replies (Comments)

1. Add the Instagram node and set Resource to Comments.
2. Choose an Operation:
   • List – fetch comments for a given media ID.
   • Hide / Unhide / Delete – moderate a specific comment by its comment ID.
   • Disable Comments / Enable Comments – toggle comments on a media object by its media ID.
   • Send Private Reply – send a private reply message to a commenter using their comment ID.
3. Provide the required IDs:
   • Media ID for listing comments or enabling/disabling comments.
   • Comment ID for hide/unhide/delete/private reply operations.
4. For Send Private Reply, also fill in:
   • Node – the Instagram professional account ID that owns the commented media.
   • Message – the private reply text that will be sent to the commenter’s inbox/request folder (subject to the 7‑day and messaging window rules defined by Meta).

Reading IG User profile and media (IG User)

1. Add the Instagram node and set Resource to IG User.
2. Choose an Operation:
   • Get – fetch basic profile information for an Instagram Business/Creator account (username, name, bio, website, media_count, followers/follows, profile picture URL).
   • Get Media – list media owned by that account, including media type, URLs, caption, permalink, timestamp and username.
3. Provide:
   • Node – the IG User ID of the professional account you want to read (or me if your credential token belongs to that account).
   • Graph API Version – the Graph version to use (for example v24.0).

Searching hashtags and fetching hashtag media (IG Hashtag)

1. Add the Instagram node and set Resource to IG Hashtag.
2. Choose an Operation:
   • Search – look up a hashtag by name and get its global hashtag ID.
   • Get Recent Media – get the most recently published media tagged with a hashtag.
   • Get Top Media – get the most popular media tagged with a hashtag.
3. For Search, provide:
   • Node – the IG User ID performing the query.
   • Hashtag Name – the hashtag name, without #.
4. For Get Recent Media / Get Top Media, provide:
   • Node – the IG User ID performing the query.
   • Hashtag ID – the ID returned from the search operation.
   • Return All / Limit – choose whether to fetch all available media (within a safety cap) or only up to a limit.

Sending direct messages (Messaging)

1. Add the Instagram node and set Resource to Messaging.
2. Choose Operation Send Message.
3. Provide:
   • Node – the IG professional account ID that will send the message.
   • Graph API Version – the Graph version to use (for example v24.0).
   • Recipient IG User ID – the Instagram-scoped user ID (IGSID) of the recipient, typically obtained from Messaging webhook events.
   • Message Text – the text body of the direct message.

Token exchange, refresh and /me (Auth)

1. Add the Instagram node and set Resource to Auth.
2. Choose an Operation:
   • Exchange Access Token – exchange a short-lived Instagram User access token for a long-lived token.
   • Refresh Access Token – refresh an existing long-lived token using the Instagram Platform refresh endpoint.
   • Get Me – call the Graph API /me endpoint using the instagramApi credential’s access token.
3. For Exchange Access Token, provide:
   • Short-Lived Access Token – the short-lived token from your login flow.
   • App Secret – the Instagram App Secret from your Meta App Dashboard.
4. For Refresh Access Token, optionally provide:
   • Access Token – the long-lived token to refresh. Leave empty to use the token from the credential.
5. For Get Me, the node uses a fixed, versioned /me URL under the hood and does not depend on any UI parameters, so older workflows remain compatible.

Getting the Instagram account for a Facebook Page (Page)

1. Add the Instagram node and set Resource to Page, Operation to Get Instagram Account.
2. Provide:
   • Graph API Version – for example v24.0.
   • Page ID – the Facebook Page ID that is linked to your Instagram professional account.
3. The node calls:
   • GET /{page-id}?fields=instagram_business_account
     and returns the instagram_business_account object (including the Instagram User ID) so you can feed it into other resources (Image/Reels/Stories/Carousel/IG User).

Trial Reels (Reels with trial_params)

1. Add the Instagram node and set Resource to Reels, Operation to Publish.
2. Under Additional Fields, set Trial Reel – Graduation Strategy:
   • MANUAL – you will decide in the Instagram app when (or if) to graduate the trial reel.
   • SS_PERFORMANCE – Instagram will automatically graduate the trial reel if it performs well.
3. The node sends a trial_params JSON object in the create-container request, as documented in the IG User Media reference.

Resources

• n8n community nodes documentation
• Instagram Graph API - Publishing
• Video/Reels publishing guide
• Comment Moderation
• Private Replies
• IG User
• IG Hashtag Search
• IG Hashtag Recent Media
• IG Hashtag Top Media
• Instagram Messaging API
• Instagram Platform Access Token
• Instagram Platform Refresh Access Token
• Instagram Platform /me
• Webhooks from Meta (getting started)
• Instagram webhook reference

Version history