@mookielianhd/n8n-nodes-instagram
v2.1.0
Published
Instagram node for n8n
Maintainers
Keywords
Readme
@mookielianhd/n8n-nodes-instagram
This package adds an Instagram Publishing node to n8n so you can send media to your Instagram Business accounts without leaving your workflow.
Instagram Publishing is powered by the Facebook Graph API and allows programmatic upload of images, reels and stories to any Instagram Business or Creator account.
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 three resources that follow the same two-step publish flow (media container creation + media publish):
| Resource | Description |
| --- | --- |
| Image | Publish a single image with an optional caption. |
| Reels | Publish a reel video. Handles container polling until the video is processed. |
| Stories | Publish a story video using the same logic as reels with media_type=STORIES. |
Credentials
Create an Instagram API credential that stores a long-lived Facebook Graph API user access token with instagram_basic, pages_show_list, instagram_content_publish, and pages_read_engagement permissions.
Steps:
- Make sure the Instagram account is a Business/Creator account connected to a Facebook Page.
- Use Meta’s Graph Explorer or your own app to generate an access token that includes the scopes listed above.
- Convert it to a long-lived token and paste it into the credential’s Access Token field.
- The built-in credential test hits
https://graph.facebook.com/v22.0/meto confirm the token works.
Compatibility
- Built against n8n 1.120.4 (community-node CLI v0.16).
- Requires n8n
>=1.0with community nodes enabled. - Uses only built-in n8n dependencies, so it is Cloud-compatible.
Usage
- Add the Instagram node to your workflow and select one of the resources (Image/Reels/Stories).
- Provide the Instagram Business Account ID (the “Node” parameter), media URL and caption.
- The node first creates the media container, polls Graph API until processing completes, then triggers
media_publish. - Handle any errors returned by the API (rate limits, permissions) via the node’s error output or
Continue On Fail.
Resources
Version history
| Version | Notes | | --- | --- | | 0.1.0 | Initial release with Image, Reels and Stories publishing & built-in container polling. |
