step by step
How to post to Instagram with the API
Create a key, connect Instagram, then schedule a post.
Open Dashboard → AI & API, create a key, and send it as Authorization: Bearer pw_live_…. Connect your Instagram account if you have not already.
Endpoints
API base URL
https://postwing.io/api/v2Docs
https://postwing.io/docsCall POST /posts with a caption, a time, your Instagram account id from GET /accounts, and media. Full field reference is in the API docs.
curl -s -X POST "https://postwing.io/api/v2/posts" \
-H "Authorization: Bearer pw_live_…" \
-H "Content-Type: application/json" \
-d '{
"caption": "New Reel from the Instagram posting API",
"scheduled_at": "2026-10-05T18:00:00Z",
"accounts": [
{
"id": "INSTAGRAM_ACCOUNT_ID",
"options": {
"share_to_feed": true
}
}
],
"media": [
{
"url": "https://cdn.example.com/reel.mp4",
"type": "video",
"cover": {
"url": "https://cdn.example.com/cover.jpg"
}
}
]
}'what you can do
Instagram posting from one API
Same PostWing API as the full product, scoped to Instagram when you post to a Instagram account.
- Schedule Instagram feed posts, carousels, and Reels
- Upload images and videos with a direct upload URL
- Set custom Reel covers with media[].cover
- Control share_to_feed and trial_reel options
- Edit or cancel scheduled Instagram posts from the same API
built for Instagram
Feed posts and Reels in one flow
Upload media, set a caption (or leave it empty), pick a time, and target Instagram. Add a cover image for Reels, or share the Reel to the main feed when you want both.
- Images and carousels publish to the Instagram feed
- Videos publish as Reels, with optional custom covers
- Scheduled posts show up on your PostWing calendar
Instagram options
Platform settings that matter
Set these on accounts[].options when you need more control.
share_to_feedfor Reels that also go to the main feedtrial_reeloff, manual, or performance for trial Reels when eligiblemedia[].coverfor a custom Reel cover (set on the media item)- Clear errors with a code and the exact field to fix
- API key or OAuth with scoped access
one API
Same API for every network
There is no separate Instagram product. List more account ids in accounts on the same call. Add Instagram, TikTok, YouTube, LinkedIn, X, Facebook, Pinterest, or Threads without changing your integration.
- Threads
- YouTube
- X (Twitter)
- TikTok
Connect accounts once in PostWing (or via the accounts endpoints)
Call POST /posts with every account you want on that post
It is on your calendar. One key covers every platform PostWing supports.
questions
Instagram posting API FAQ
Yes. Upload a video, schedule it to your Instagram account, and optionally set a custom cover with media[].cover. PostWing treats Instagram video as a Reel.