INSTAGRAM

Instagram Posting API: Publish & Schedule Reels, Stories and Posts

Publish Reels, Stories and feed posts to Instagram with a single API key. No Meta App Review, and no container-and-polling flow to build. Connect a Business or Creator account, then post from your own app, an AI agent or n8n.

Free plan · 2 accounts · No credit card · API + MCP included

SEND FROMYour appAI agentn8n / ZapierPOST /v1/posts · INSTAGRAM · REEL← published · 1,240 viewsWoopSocialMeta app approvedValidateBusiness accountConvert video1080 × 1920ScheduleFri 18:00Publish via Metatoken refreshedyour_brandInstagramREEL000webhook + analytics
  • Feed posts
  • Carousels
  • Reels
  • Stories
  • Trial Reels
  • Reel covers

WoopSocial vs the Instagram Graph API

Comparison of Instagram Graph API direct versus WoopSocial for publishing
Instagram Graph API directWoopSocial
Register a Meta app and pass App Review (multi-week cycles) before you can publish for other accountsAlready approved. Connect an account and start posting
Create a media container, poll its status, then publishOne POST /posts call
Host your media at a public URL that matches Meta's specsUpload files up to 5 GB, resized and transcoded for each format
Build your own scheduler and retry logicSCHEDULE_FOR_LATER, drafts and automatic retries (1 to 5)
Maintain token refresh and two separate login flowsTokens stored and refreshed for you
Metric renames break dashboards (impressions became views in 2025)Post analytics normalized on the same post object

Three steps to use the Instagram Posting API

  1. Step 1

    Connect your account

    Send yourself, or your own users, a hosted connect link (POST /social-accounts/authorization-url) and they approve access in a few clicks. The Instagram account must be a Business or Creator account linked to a Facebook Page, because WoopSocial connects through Facebook Login.

  2. Step 2

    Create the post

    Send a single request that describes the post - Your Instagram account, the format (POST, REEL or STORY), your caption and media, and when your post should go live. You can add a custom cover for Reels and turn on Trial Reels by selecting how they graduate.

  3. Step 3

    We handle the rest

    WoopSocial uploads and optimizes your media, builds the Instagram container, queues for processing and publishes the time scheduled. When a delivery fails for a temporary reason, WoopSocial retries automatically, and webhooks inform your app about the action.

Everything you need to ship features with the Instagram Posting API

Reels, Stories & feed posts

Switch between POST, REEL and STORY with one postType field. The rest of the request stays the same, so adding a new format doesn't mean learning a new endpoint.

Trial Reels

Test a Reel with non-followers first. Then graduate it to your followers yourself, or let it graduate automatically based on performance (SS_PERFORMANCE).

Scheduling & drafts

Schedule to the minute in UTC, or save a post as a draft for someone to approve first. Instagram's publishing API has no native scheduling, so WoopSocial handles it for you.

Per-platform copy

Send the same Reel to TikTok and YouTube Shorts with a different caption for each, using contentOverride, all in a single request.

Media handled

Upload large videos in chunks, up to 5 GB. WoopSocial converts them to Instagram's specs, so you don't prepare a separate file for every format.

Post analytics

Get views, likes, comments, shares and saves back on each post.

Three ways in

Same Instagram publishing backend whether you talk to an AI agent over MCP, call the REST API, or drop a node into n8n, Zapier or Make.

  1. 1 · Account

    Create a free WoopSocial account

    Sign up at app.woopsocial.com/signup (no credit card). You'll authorize through OAuth when the agent connects — no API key required for MCP.

  2. 2 · Instagram

    Connect a Business or Creator account

    Link Instagram (Business/Creator + Facebook Page) in the WoopSocial dashboard before you ask an agent to post.

  3. 3 · Agent

    Add the MCP URL and authorize

    Use https://api.woopsocial.com/mcp. Your client opens OAuth — approve access and you're connected. Docs: Integrating MCP clients.

Install by client

Pick your agent. Cards marked On this site open another WoopSocial page; External opens outside this site (new tab).

Config for Cursor / other MCP clients

Prefer 1-click? Install the WoopSocial Cursor plugin. Or paste this into .cursor/mcp.json (or your client's MCP config). Authorize with OAuth when prompted — no API key in the URL. Allowlist *.cloudflarestorage.com if media uploads are blocked.

json
{
  "mcpServers": {
    "woopsocial": {
      "url": "https://api.woopsocial.com/mcp"
    }
  }
}

Claude Code

One command registers the remote HTTP MCP server. Complete OAuth when prompted.

bash
claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp"

After install — try this

Plain-language Instagram prompt

You

Ask Claude: Schedule this Reel to Instagram for Friday 6pm Amsterdam time

Prefer a full walkthrough with screenshots? Start at /social-media-mcp.

REST API example: schedule an Instagram Reel

Same POST /posts call with a Bearer API key. Authorization header and request body included.

bash
curl -X POST https://api.woopsocial.com/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": [{
      "text": "New Reel - shipping this week.",
      "media": [{ "type": "MEDIA_LIBRARY", "mediaId": "MEDIA_ID" }]
    }],
    "schedule": {
      "type": "SCHEDULE_FOR_LATER",
      "scheduledFor": "2026-07-01T16:00:00Z"
    },
    "socialAccounts": [{
      "platform": "INSTAGRAM",
      "socialAccountId": "YOUR_IG_ACCOUNT_ID",
      "postType": "REEL"
    }]
  }'

Prefer a calendar? Schedule Instagram posts from the dashboard

Not everyone wants to touch an API. If you prefer to plan content visually, the WoopSocial dashboard shows a calendar where you can specify the date and time you want Instagram to post. Connect multiple Instagram accounts, and see them all side by side, perfect for agencies and for anyone managing more than one brand.

AI captions get you over the dreaded blank page, while cross-posting allows you to send the same content to other platforms from the same screen. The dashboard shares the same backend with the API so a post your team schedules in the calendar is exactly the same as one your code creates. The free plan allows 2 accounts, does not require a credit card, and is completely free.

Schedule from the dashboard
WoopSocial calendar for scheduling Instagram posts

Instagram API requirements & limits

  • Professional account

    You need an Instagram Business or Creator account linked to a Facebook Page, because WoopSocial connects through Facebook login, and Meta's API doesn't support personal accounts.

  • Captions

    Up to 2,200 characters, 30 hashtags and 20 @mentions per caption. If an AI agent writes your captions, it helps to put these limits in the prompt.

  • Carousels

    Up to 10 images or videos in one carousel. Add all the media to a single post and it publishes as one easily swipeable carousel.

  • Reels

    Videos from 3 seconds to 15 minutes long. Vertical 9:16 is the recommended aspect ratio.

  • Stories

    Video Stories can be up to 60 seconds long. Plan your clip length around that limit - longer videos won't fit in a single Story.

  • Daily publishing limit

    Meta allows up to 100 API-published posts per account in 24 hours. Check Meta's documentation for more specific details.

  • Feed images

    Aspect ratios from 4:5 to 1.91:1 are supported. Portrait 4:5 is the tallest format allowed - it takes up the most room in the feed.

  • Story lifetime

    Stories disappear 24 hours after they're published. Try your best to schedule them for a time when your audience is most likely to be watching.

Post the same Reel to TikTok, YouTube Shorts and Facebook Reels in one call.

FAQ

Yes. WoopSocial's Meta app is already approved for publishing, so you connect your Instagram account and start posting. You don't submit your own app or wait through Meta's long cycles. If you need a guide to help you with rejections, our Meta App Review Rejected guide explains the usual causes.
Business and Creator accounts that are linked to a Facebook Page. WoopSocial connects through Facebook Login, so that link to a Page is required. Personal Instagram accounts aren't supported, because Meta's publishing API doesn't allow them, whichever tool you use to post.
Yes. Set postType to REEL or STORY, then use SCHEDULE_FOR_LATER with a UTC timestamp. Instagram's own publishing API has no scheduling option, so WoopSocial can hold the post and publishes it at the time you choose. You can also save it as a draft first.
Trial Reels displays your Reel to new people (non-followers) first, so you get to test it before your audience sees it. Through the API, trialParams.graduationStrategy determines what happens next: MANUAL lets you graduate the Reel yourself, while SS_PERFORMANCE will graduate the Reel automatically, based on performance.
Yes. Just add a cover to your Reel request using an image from your WoopSocial media library, and Instagram will use that as the cover of the Reel. This also works for scheduled Reels, so you can prepare the entire post in advance.
Yes. You can add multiple images to one post, which will then be published as a carousel (up to a maximum of 10 in one post). The process of scheduling a carousel is the same as for any other feed post, you can choose a publish time or leave it as a draft.
Woopsocial doesn't put a limit on the amount of Instagram posts on any of its plans. Meta does though - its docs says 100 API-published posts per account are allowed in any rolling 24 hour period and a carousel is treated as a single post. For the vast majority of accounts, that ceiling is well beyond what you would ever post. See Meta's docs for more insights.
Yes, at the post level and account level. For each post, you get views, likes, comments, shares and saves with the metric names normalized for you after Meta changed impressions to views in 2025. You can also get insights for account-level information like demographics of followers.
Yes. WoopSocial's MCP server works in Claude, ChatGPT and Cursor, so you can ask an assistant to schedule a Reel in plain language, and your AI client asks for approval before posting. Our guide to scheduling social media posts with MCP covers the setup.

Post to more than Instagram

Same API key. Same request format. Same across all the networks listed below. One integration for all of these networks.

Start posting to Instagram today

“I connected WoopSocial's MCP to my AI agents, now I can post directly to all my social channels with just one command. Whenever I finish some website work or wrote a new blog post, I simply tell the AI agent to post it directly to my social media channels via WoopSocial. The content generation and bulk scheduling via the web app is also very useful. The time I spent managing social media has been reduced drastically. Gamechanger!”

Chris

Connect an Instagram account, grab a free API key and publish your first Reel in minutes. No Meta App Review, no credit card.

Free plan · 2 accounts · No credit card · API + MCP included