
Meta CreateCarousel
CertifiedPublish an Instagram carousel
Meta CreateCarousel
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.
type: io.kestra.plugin.meta.instagram.media.CreateCarouselExamples
Create a carousel post
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
accessToken *string
Access Token
Access token with required scopes (e.g., instagram_basic, instagram_content_publish).
igId *string
Instagram Account ID
ID of the Instagram professional account to act on.
mediaUrls *array
Media URLs
Public URLs for 2-10 media items; JPEG for images, MP4/MOV for videos.
apiVersion string
v24.0API Version
Instagram Graph API version to call. Defaults to v24.0.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150caption string
Caption
Optional caption text for the carousel post.
host string
https://graph.facebook.comHost URL
Base Graph API URL. Defaults to https://graph.facebook.com.