InstagramInstall

Summary

Publish a carousel (album) post with 2 to 10 images or videos on an Instagram Business Account using the Facebook Graph API.

Inputs

• Node (required) — The Instagram Business Account ID or User ID to publish the carousel on (e.g., "me").
• Graph API Version (required) — The Facebook Graph API version to use for requests, e.g., v22.0.
• Caption (required) — The caption text to accompany the carousel post.
• Carousel Input Mode (required) — Choose whether to manually specify each media item in the node or read media items from an incoming field.
• Carousel Media (Manual Mode) — Up to 10 media items specifying media type (image or video) and corresponding URLs, manually configured in the node.
• Media Array Field Name (FromField Mode) — The field name on the incoming item that contains an array of media URLs or objects to build the carousel from.
• Media Type for Array URLs (FromField Mode) — How to determine if each media URL is an image or a video: auto-detect, all images, or all videos.

Output shape

a single JSON object representing the published carousel media as returned from the Instagram API

The operation creates individual media containers for each carousel item, waits for each to be ready, then creates and publishes the carousel container. It handles polling for readiness and retries on media not ready errors. Errors during container creation or publishing are reported per item, and the operation requires at least 2 and at most 10 media items in the carousel.

Links

• n8n community nodes installation guide