Platform guide · Visual
Publish feed photos and Reels to Instagram with a single call. We run the Content Publishing container-then-publish flow, hold the token, and hand back the real media id — you send one caption and a URL.
At a glance
| API | Instagram Graph API |
| Connection | OAuth — supply an access token |
| Formats | Video, Image, Story |
| Character limit | 2,200 |
| Media | Supported — pass a public URL |
Connect Instagram
Instagram connects over OAuth. Complete the network’s OAuth to mint an access token, then connect Instagram from the dashboard’s Accounts page. These are the fields it needs:
| Field | Send as | Required | Where to find it |
|---|---|---|---|
| Access tokensecret | accessToken | Required | Long-lived IG Graph token |
| IG user id | externalId | Required | The Instagram professional account id |
Everything marked secret is sealed with AES-256-GCM before storage — see Connecting accounts.
Publish to Instagram
Once connected, Instagram is just another id in your platforms array. One call publishes:
curl https://postmyish.com/api/v1/posts \
-H "Authorization: Bearer $POSTMYISH_KEY" \
-H "Content-Type: application/json" \
-d '{"caption":"New drop is live 🔥 link in bio","platforms":["instagram"]}'The same request can fan out to TikTok, Facebook, Threads and more — add their ids to the array. See Publish everywhere at once.
What you can do
- Feed photos. An image URL posts straight to the grid with your caption.
- Reels. Pass a video URL as media and it publishes as a Reel.
- Captions to 2,200. Full caption length, hashtags and @mentions preserved.
- Schedule ahead. Add schedule_at and it fires from our queue, not yours.
Setup & review
FAQ
Is this the official Instagram API?
Yes — the Instagram Content Publishing API, part of the Instagram Graph API. No scraping or automation-of-the-app tricks.
Do I need a Business account?
Yes. Instagram only allows API publishing to Professional (Business or Creator) accounts linked to a Facebook Page. Personal accounts can't be posted to by any provider.
Can I post Reels?
Yes. Pass a video URL as media and Instagram publishes it as a Reel; an image URL posts to the feed.
Why does it need a public media URL?
The Graph API pulls the file from a URL you host rather than accepting an upload. Pass media as an https URL and it flows straight through.
Can I schedule Instagram posts?
Yes — add schedule_at (ISO 8601) and PostMyIsh publishes it from our queue when the time arrives.