1. Social Networks
swonkie.dev
  • Introduction
  • Quick Start
  • Changelog
  • Social Networks
    • Facebook
    • Instagram
    • LinkedIn
    • TikTok
    • Threads
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Insights
    • Getting Started
    • My Profile Insights
      GET
    • My Profile Insights Posts
      GET
    • Competitor Insights
      GET
    • Competitor Insights Posts
      GET
  • Posts
    • Getting Started
    • List Posts
      GET
    • Get a Post
      GET
    • Create a Post
      POST
    • Update a Post
      PUT
    • Validate a Post
      GET
    • Delete a Post
      DELETE
    • Change Post Stage
      PATCH
  • Labels
    • Getting Started
    • List Labels
      GET
    • Create a Label
      POST
  • Media
    • Get a Media
    • Create a Media
    • Upload File to Media
    • Confirm Uploaded Media
    • Delete a Media
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Social Networks

Instagram

Instagram supports image, video, story, and reel post types. Captions are not supported on story posts.

Supported Post Types#

Post TypeDescription
MEDIAOne or more images or videos
STORYFull-screen image or video story
REELShort-form vertical video

Network Options#

Instagram-specific settings are passed in the instagram object on the post body.
FieldTypeDescription
shareToFeedbooleanWhen true, also shares a Story post to the profile feed

Examples#

MEDIA post#

STORY post shared to feed#

REEL post#


Notes#

Captions are not supported on STORY posts. Including a caption on a story will have no effect.
shareToFeed only applies to STORY posts. It has no effect on other post types.
The net field on captions and media can be omitted to apply the content to all networks assigned to the post.
First comments (captions[].firstComment) are supported on Instagram but may be ignored if the network does not support the feature at the time of publishing.
Modified at 2026-03-12 18:22:01
Previous
Facebook
Next
LinkedIn
Built with