Skip to main content
The Instagram node adds Instagram operations to your workflows. Add it on the canvas or ask the AI builder for it by name, then pick an operation and fill in its fields. Instagram also includes 3 trigger operations (marked in the tables below) that can start a workflow when something happens in Instagram.
You can wire the Instagram node into an AI agent as a tool provider: the agent calls the operations you allow. See Agent tools.
Instagram has two kinds of connection. The Login option below signs you in with an Instagram professional account and needs no Facebook Page. The Facebook login, System user token, and Page access token options reach Instagram through Facebook, which needs a Page linked to the account.Hashtag search, product tagging, and business discovery are not part of a Login connection. On one, Search Hashtag Id, Get Hashtag Media, Discover Business Account, Tag Products in Media, Get Media Product Tags, and Delete Product Tags from Media stop with a message telling you to connect through Facebook Login instead.
Get Mentioned Media and Get Mentioned Comments each look up one mention by its id, in the Media ID and Comment ID fields. Instagram has no endpoint that lists mentions, so the id comes from the mentions webhook Instagram sends when someone @mentions the account. On Comment and On Message start a run when someone comments on the connected account’s posts or sends it a direct message. Instagram signs and pushes each event, so nothing is polled. Both triggers need a Login connection, and they do not make the list operations return anything they did not return before. Set Media ID on On Comment to receive comments on one post only, or Sender ID on On Message to receive messages from one Instagram-scoped sender only. Leave either blank to receive events across the connected account. Comments the account wrote itself and echoes of messages it sent are skipped, so an automated reply cannot trigger the workflow again. Running either step by hand reports that no event was delivered, because events reach the workflow through the trigger rather than through the step. The trigger’s Status field means the subscription is registered with Instagram, not that a delivery has been seen. Instagram’s own permissions decide which accounts events are delivered for. On Mention starts a run when the connected account is @mentioned in a comment or a public post/Reel caption, including on someone else’s post. Both are included by default. Connect an Instagram with Facebook Login credential through a linked Facebook Page, and wire this trigger to an HTTP Request step to send the enriched event to your own backend. Mentions on other accounts’ posts reach NoClick through the Facebook Page linked to your Instagram account, so On Mention is the one Instagram trigger that uses the Instagram with Facebook Login connection rather than Instagram Login. Sign in with the Facebook profile that has access to that Page, and include the Page on Facebook’s consent screen. If the Page belongs to a business portfolio, select that portfolio and allow business access as well, or Facebook returns no Pages to choose from. An On Mention trigger still on an Instagram Login connection keeps working for mentions on your own posts, and its Status field says to reconnect it through Facebook Login for mentions on other accounts’ posts. The output’s data contains mention_type (comment or caption), text, author, comment_id, media_id, comment, media, and media_urls. Comment authors come from the webhook or the mentioned comment’s requested from field; caption authors come from the media username. Use data.author.username to identify who wrote the mention; mentioned_username identifies the connected recipient. author_available and media_url_available tell you whether Meta supplied those values. Carousel child URLs are included when returned by the comment’s media expansion. Use data.event_id as an idempotency key in your backend. For an HTTP Request step, choose Send HTTP POST Request, set your endpoint, select a JSON body, and use {{ JSON.stringify($('ig').data) }} as the body, replacing ig with your Instagram node ID. The JSON includes event_id for deduplication in your backend.
Private posts and Story mentions are not supported by this trigger. Meta can omit a media URL for restricted content. An ID-only mention notification is enriched by reading the comment, including its author; if Meta still returns no author, author_available is false. Meta also removes the @ symbol from other accounts’ captions returned by the Mentioned Media API; the trigger preserves original webhook text when present and supplies mentioned_username separately. An active connection or registered subscription does not establish live webhook access: Meta’s app mode, permissions and review status still apply.

Credentials

Connect Instagram under Credentials in the node settings. See Connecting credentials for the general flow.

Login

Sign in with your Instagram account when prompted; no keys to copy. NoClick requests the following permissions:
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages

Facebook login

Sign in with your Instagram account when prompted; no keys to copy. NoClick requests the following permissions:
  • instagram_basic
  • instagram_content_publish
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement
  • pages_manage_metadata
  • ads_read
  • business_management

System user token

Enter the values manually when creating the credential. Get your credentials here.

Page access token

Enter the values manually when creating the credential. Get your credentials here.

Operations

Comment

Hashtag

Media

Messaging

Profile

Story