Meta CreateCarousel

Meta CreateCarousel

Certified

Publish an Instagram carousel

Creates and publishes a carousel with 2-10 media items (images or videos) to a professional account. Fails if the media count is outside the allowed range.

yaml
type: io.kestra.plugin.meta.instagram.media.CreateCarousel

Create a carousel post

yaml
id: instagram_create_carousel_post
namespace: company.team

tasks:
  - id: create_carousel_post
    type: io.kestra.plugin.meta.instagram.media.CreateCarousel
    igId: "{{ secret('INSTAGRAM_ACCOUNT_ID') }}"
    accessToken: "{{ secret('INSTAGRAM_ACCESS_TOKEN') }}"
    mediaUrls:
      - "https://example.com/image1.jpg"
      - "https://example.com/image2.jpg"
      - "https://example.com/video1.mp4"
    caption: "Check out this amazing carousel!"
Properties

Access Token

Access token with required scopes (e.g., instagram_basic, instagram_content_publish).

Instagram Account ID

ID of the Instagram professional account to act on.

SubTypestring

Media URLs

Public URLs for 2-10 media items; JPEG for images, MP4/MOV for videos.

Defaultv24.0

API Version

Instagram Graph API version to call. Defaults to v24.0.

Caption

Optional caption text for the carousel post.

Defaulthttps://graph.facebook.com

Host URL

Base Graph API URL. Defaults to https://graph.facebook.com.

Reference (ref) of the pluginDefaults to apply to this task.