Post an Instagram Reel with Python, without building a Meta app
Post an Instagram Reel from Python using eksis REST API. Complete example with media import, channel lookup, and polling until published. Business and Creator accounts only.

On this page
You can post an Instagram Reel with Python using the Instagram Graph API or a REST API from a scheduler. The raw Meta API needs a Business or Creator account, a Meta app, Advanced Access approval, a media container, and polling. A simpler way is to use a scheduler's REST API that already has approval.
The short answer
- Raw Graph API: create a media container, upload the Reel to it, poll its status, then publish. That is three to four API calls and approval from Meta.
- Python with requests: use a scheduler like eksis that publishes Reels through its own Meta app: import the video, create the post, check its status. No Meta app of your own, available on every paid plan.
- Account type: Instagram Reels require a Business or Creator account. Personal accounts are rejected.
- Reel specs: 3 seconds to 15 minutes, vertical video.
- Limits: eksis Free plan has no REST API. Paid plans (Pro Eksis, Super Eksis) follow Instagram's 100 posts per Instagram account per rolling 24 hours.
Raw Graph API: how Meta publishing works
If you build your own Meta app, the flow to publish a Reel takes multiple steps:
- Create a media container with
POST https://graph.instagram.com/{ig-user-id}/media, postingmedia_type=REELSand a video URL. Use an Instagram Login token. - Get the container ID from the response. Meta downloads the video in the background.
- Poll the container status with
GET https://graph.instagram.com/{creation-id}?fields=status_code, watching forstatus_code:PROCESSING,FINISHED,EXPIRED,ERROR, orIN_PROGRESS. - Once finished, publish with
POST https://graph.instagram.com/{ig-user-id}/media_publish, passing thecreation_id.
Each step returns a status. If the video is too large or in the wrong format, the container fails at step 3 and you see an error code. The whole flow takes seconds to minutes.
Media container creation
curl -X POST https://graph.instagram.com/{IG_USER_ID}/media \
-d media_type=REELS \
-d video_url=https://example.com/reel.mp4 \
-d caption="Your caption" \
-d access_token=your_token
Response:
{
"id": "creation_id_here"
}
Poll the container
curl "https://graph.instagram.com/creation_id_here?fields=status_code&access_token=your_token"
Possible status codes: PROCESSING, IN_PROGRESS, FINISHED, EXPIRED, ERROR. Keep polling until you see FINISHED, EXPIRED, ERROR, or a timeout. Polling every 1 to 2 seconds is reasonable. Once finished, move to publishing.
Publish the Reel
curl -X POST https://graph.instagram.com/{IG_USER_ID}/media_publish \
-d creation_id=creation_id_here \
-d access_token=your_token
Once published, the Reel appears on the profile.
With Python and eksis REST API
Instead of building a Meta app, use a scheduler's REST API. eksis has its own approved Meta app, so a few Python calls post the Reel without an app review of your own.
Prerequisites
- Every paid plan (Pro Eksis, Super Eksis). Free has no REST API.
- An Instagram Business or Creator account connected to eksis.
- An eksis API key, created on the API & MCP page of your workspace (how to create one).
- Python 3 with the requests library:
pip install requests.
Complete example
import requests
import time
# API setup
API_KEY = "eksis_sk_your_key_here"
BASE_URL = "https://api.eksis.io/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# Step 1: Import the video
print("Importing video...")
media_response = requests.post(
f"{BASE_URL}/media/imports",
headers=HEADERS,
json={"url": "https://example.com/reel.mp4"}
)
media = media_response.json()["data"]
media_id = media["id"]
print(f"Media imported: {media_id}")
# Step 2: Get your Instagram channel
print("Fetching channels...")
channels_response = requests.get(
f"{BASE_URL}/channels",
headers=HEADERS
)
channels = channels_response.json()["data"]
# Find your Instagram Business/Creator account
instagram_channel = None
for channel in channels:
if channel["platform"] == "instagram" and channel["status"] == "active":
instagram_channel = channel
break
if not instagram_channel:
print("No active Instagram channel found")
exit()
print(f"Using channel: {instagram_channel['id']}")
# Step 3: Create the post
print("Creating post...")
post_response = requests.post(
f"{BASE_URL}/posts",
headers=HEADERS,
json={
"caption": "Check out my new Reel",
"mediaIds": [media_id],
"targets": [
{
"channelId": instagram_channel["id"],
"contentType": "reels"
}
],
"mode": "now"
}
)
post = post_response.json()["data"]
print(f"Post created: {post['id']}")
print(f"Status: {post['status']}")
# Step 4: Poll until published or terminal state
print("Polling until published...")
post_id = post["id"]
max_wait = 300 # 5 minute timeout
elapsed = 0
poll_interval = 2
while elapsed < max_wait:
post_check = requests.get(
f"{BASE_URL}/posts/{post_id}",
headers=HEADERS
).json()["data"]
target = post_check["targets"][0]
target_status = target["status"]
print(f"Target status: {target_status}")
if target_status == "published":
print(f"Published: {target['permalink']}")
break
elif target_status in ["failed", "held", "cancelled"]:
print(f"Terminal state: {target_status}")
if "error" in target:
print(f"Error: {target['error']}")
break
time.sleep(poll_interval)
elapsed += poll_interval
if elapsed >= max_wait:
print("Polling timeout after 5 minutes")
What the code does
- Import the video: POST to
/v1/media/importswith a public URL. eksis downloads it into the media library. - Get your channel: GET
/v1/channelsto find your Instagram Business or Creator account. - Create the post: POST to
/v1/postswithcontentType: "reels",mode: "now"to publish immediately. - Poll the status: GET
/v1/posts/{id}repeatedly untiltargets[0].statusispublished,failed,held, orcancelled, or 5 minutes elapse.
The response includes the post permalink once it is live.
Response when published
{
"id": "post_id",
"status": "published",
"targets": [
{
"channelId": "instagram_channel_id",
"contentType": "reels",
"status": "published",
"permalink": "https://www.instagram.com/reel/ABC123/"
}
]
}
Error handling
A request that breaks a rule, such as an unsupported value, is refused with 422 and the code validation.failed, with a message that says what to fix. A post can also be accepted and then fail on Instagram's side; then the target's status is failed and its error holds a code and message, which is why the example prints target['error'].
Account requirements
Both the Graph API and eksis require a Business or Creator account. A Personal Instagram account cannot post Reels through any API. If you are on Personal, switch to Creator in Instagram Settings.
Reel specifications
Instagram Reels through the API accept:
- Video: 3 seconds to 15 minutes long, vertical (9:16 is the usual shape).
- Frame rate: 23.976 to 60 fps recommended.
- Codec: H.264 video, AAC audio.
If your video is too long or in landscape, convert it first:
ffmpeg -i input.mp4 -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -c:a aac output.mp4
Plans and limits
- Free: no REST API, no Reels through API.
- Pro Eksis, Super Eksis: REST API available. Instagram allows up to 100 posts per account per rolling 24 hours. eksis has no additional cap on paid plans.
Sources
- Instagram Graph API: Media container (read November 11, 2026)
- Instagram Graph API: Publish a media container (read November 11, 2026)
- eksis docs: Quick start (read November 11, 2026)
- eksis docs: Instagram platform specifications (read November 11, 2026)
- eksis REST API: Create a post (read November 11, 2026)
Frequently Asked Questions
Can I post a Reel without a Business or Creator account?
No. Instagram only allows Business and Creator accounts to post through the API. Switch to Creator in Instagram Settings to use the API.
Does the video upload automatically when I import it?
Yes. When you POST to /media/imports with a public URL, eksis (or your own backend) downloads the file into storage. From there, you can use it for multiple posts.
Can I schedule a Reel instead of posting now?
Yes. In the eksis example, change "mode": "now" to "mode": "schedule" and add "scheduledAt": "2026-11-15T09:00:00Z". The Reel publishes at that time.
How long does it take for a Reel to appear after publishing?
Instagram processes the video before it goes live, so expect a short wait. The polling loop in the example waits until the target is published, or stops after 5 minutes.
What if the video is too large?
Check the file against the Instagram limits in the eksis platform specifications before you import it. If a post fails, the target's error.code and error.message say why.


