Distribution Publishing

Publish carousel content and inspect distribution records.

Destination-specific publish docs cover single media and carousel publishing. Use this page when you need the carousel response shape, account lookup context, or publish history context. For connected accounts, start with Distribution accounts.

Instagram carousel publishing

POST/api/v1/publish/instagram/carousel

Parameter	Type	Required	Description
mediaIds	string[]	Yes	2 to 10 image media IDs. Instagram carousels only accept images.
instagramAccountId	string (UUID)	Yes	Connected Instagram account to publish to.
caption	string	No	Optional caption, up to 2200 characters.

This endpoint creates a publish record for a carousel post and returns the Instagram publish ID, IG media ID, permalink, and image count.

{
  "instagramPublishId": "b2d7e2ae-1d3d-4c88-8f01-0d2c8fb2d9b1",
  "igMediaId": "1789...",
  "permalink": "https://instagram.com/p/...",
  "imageCount": 4
}

Use this endpoint for carousel publishing. The direct Instagram publish endpoint handles a single image or video asset.

TikTok photo carousel publishing

POST/api/v1/publish/tiktok/carousel

Parameter	Type	Required	Description
mediaIds	string[]	Yes	2 to 35 media IDs. TikTok carousels only accept JPEG or WebP images.
tiktokAccountId	string (UUID)	Yes	Connected TikTok account to publish to.
caption	string	No	Optional caption, up to 90 characters.
privacyLevel	string	No	PUBLIC_TO_EVERYONE \| MUTUAL_FOLLOW_FRIENDS \| FOLLOWER_OF_CREATOR \| SELF_ONLY. Defaults to SELF_ONLY and is ignored when postMode is inbox.
postMode	string	No	direct \| inbox. Defaults to direct.
coverIndex	number	No	Index of the cover image to use. Defaults to 0.

TikTok carousel publishing also rejects S3-backed media. Use GCS-hosted images only, and keep the direct publish endpoint for single-video posts.

{
  "tiktokPublishId": "c34a4b1f-b2ff-4f3f-a4fb-6cf2ca8f9e2c",
  "publishId": "v0...",
  "tiktokMediaId": "v0...",
  "imageCount": 6
}