Creating Carousels and Multi-Media Posts

Post carousels simply by passing multiple media in a post

Your users will often want to share more than just a single image or video. Post for Me makes publishing carousels and multi-image posts incredibly straightforward across all supported platforms.

Here is a breakdown of how to seamlessly handle multiple media assets in a single post request.

The Core Concept

A carousel is a single social media post that contains multiple media assets, allowing users to swipe or click through a gallery of content.

How it works

To publish a carousel, you do not need to use a special endpoint or distinct parameter. You simply pass multiple media objects into the media array when making a POST request to the /v1/social-posts endpoint.

  • Provide a valid url for each asset within the media array.

  • The API will automatically package these assets into the native carousel format for each targeted platform.

The User Experience

The end-user will see a native multi-image or multi-video post on their timeline. They can swipe or click through the content exactly as if it were posted directly from the platform's native app.

Platform and Account Overrides

You maintain full flexibility over your media, even when targeting multiple networks simultaneously.

How it works

If you want to post a multi-image carousel to Instagram but only a single image to Facebook, you can utilize the platform_configurations or account_configurations objects.

  • Simply pass a new media array containing your specific objects inside the respective platform's configuration payload.

  • This override will replace the base post's media entirely for that specific network or account, ensuring the most specific content is used.

Requirements

While the Post for Me API accepts multiple media items effortlessly, it is important to remember that each social network enforces its own native limitations. If a platform (such as X) does not natively support the number of media items you have provided in your array, the post attempt for that specific network will fail.