​

Instagram

​

API overview

​

Use cases

• Publish image-led promotional content.
• Post short-form video content to a professional account.
• Publish Instagram content without requiring a linked Facebook Page.

​

When to use

• When the connected account is an Instagram Business or Creator account.
• When the content is media-first and visually driven.

​

When not to use

• When you only have a personal Instagram profile.
• When the post is link-heavy or text-heavy.

​

Examples

​

Business photo post

{
  "platforms": [
    {
      "platform": "instagram",
      "accountId": "ig_business_123",
      "content": "New behind-the-scenes shot from the studio.",
      "mediaItems": [
        {
          "type": "image",
          "url": "https://cdn.postova.dev/studio.jpg"
        }
      ]
    }
  ]
}

​

How to post

1. Connect an Instagram Business or Creator account with Instagram Login.
2. Create image or video content with the post body you want to publish.
3. Publish to the Instagram account from the selected social profile.

​

Authentication

​

Default scopes

​

Supported media

• image
• video
• Supports image and video publishing.

​

Settings

​

Common errors

• Professional account required: The connected Instagram account is not a Business or Creator account. Fix: Switch the Instagram account to a professional account, then reconnect it with Instagram Login.

​

Constraints

• Only Instagram Business and Creator accounts are supported for publishing.

​

Notes

• Uses Instagram Login and Instagram User access tokens.