Instagram trial reels through the API: trial_params and graduation
Instagram's API publishes trial reels, which are shown only to non-followers at first, by adding trial_params to a REELS container. Its graduation_strategy sets how the reel reaches followers: MANUAL leaves it to the account owner in the Instagram app, and SS_PERFORMANCE graduates it automatically if it performs well. Meta has supported it with Instagram Login since December 2025.
easyCoexistence publishes Reels with publish_instagram_post from Claude, ChatGPT or your own code, to followers as usual: the tool takes no trial_params, so a trial reel is shared from the Instagram app.
When Meta added trial reels to the Content Publishing API, for Instagram Login and Facebook Login alike.
MANUAL, graduated by hand in the Instagram app, or SS_PERFORMANCE, graduated automatically if the trial reel performs well.
The media_type a container must have whenever trial_params is in the request.
Longest video a reel container takes; the shortest is 3 seconds and the largest file 300 MB.
How long a media container lasts unpublished before it expires.
What is a trial reel?
A reel that Instagram shares only with people who do not follow the account. Graduating it converts it into a regular reel shared with followers, either when the account owner chooses to in the Instagram app or automatically when it performs well, depending on the strategy set when it was published.
How do you publish one through the API?
With the usual reel calls and one extra parameter. Create the container with POST /<IG_ID>/media, setting media_type to REELS, the video_url, a caption and trial_params with a graduation_strategy; wait until the container's status_code reads FINISHED; then publish it with POST /<IG_ID>/media_publish, passing the container ID as creation_id.
POST https://graph.instagram.com/v26.0/<IG_ID>/media
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
{
"media_type": "REELS",
"video_url": "https://www.example.com/videos/reel.mp4",
"caption": "<CAPTION>",
"trial_params": { "graduation_strategy": "MANUAL" }
}Which graduation strategy should you pick?
MANUAL when someone will look at the results before followers see the reel: it stays with non-followers until it is graduated by hand in the Instagram app. SS_PERFORMANCE when the decision can be left to Instagram: the trial reel graduates automatically if it performs well. graduation_strategy is required inside trial_params, and those are its only two values.
Which rules still apply?
Every rule for a reel, since a trial reel is created with the same parameters plus trial_params:
- Video: MOV or MP4, from 3 seconds to 15 minutes and up to 300 MB, at a public URL Meta can fetch.
- Processing: check the container's
status_codeuntil it reads FINISHED, once a minute for no more than 5 minutes, as Meta suggests. - Expiry: a container not published within 24 hours expires and has to be created again.
- Caption: up to 2,200 characters and 20 @ tags, with up to 5 hashtags by Instagram's current rule (Meta's API reference still lists 30).
- Carousels: reels cannot appear in them.
Does it work with Instagram Login?
Yes. Meta's changelog introduced trial reels for the Instagram API with Instagram Login and with Facebook Login on 3 December 2025, and its publishing guide shows the call against graph.instagram.com. The permissions are the publishing pair: instagram_business_basic and instagram_business_content_publish.
Can a trial reel be graduated through the API?
Meta describes two ways a trial reel graduates: by hand in the Instagram app, for MANUAL, and automatically when it performs well, for SS_PERFORMANCE. Its publishing guide and media reference describe no API call for graduating, so the API's part ends once the trial reel is published.
How do you publish a trial reel from Claude or ChatGPT?
Not through easyCoexistence today. publish_instagram_post creates the Reel's container itself and takes no trial_params, so the Reels it publishes go to followers as usual, and Instagram tokens are not handed out for a call of your own. Share a trial reel from the Instagram app, with the Trial switch on the share screen.
Common mistakes
- Adding trial_params to a photo, carousel or Story container. Meta accepts it only when media_type is REELS.
- Leaving graduation_strategy out. It is required inside trial_params, as MANUAL or SS_PERFORMANCE.
- Publishing before the video has processed. media_publish succeeds only once the container's status_code reads FINISHED.
- Expecting followers to see a trial reel when it is published. It goes to non-followers only until it graduates.
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Can the Instagram API publish trial reels?
Yes. Add trial_params with a graduation_strategy to a REELS container and publish it as usual, with Instagram Login or Facebook Login.
Can trial_params be used on a photo or carousel?
No. Meta accepts trial_params only on a container whose media_type is REELS, so photo, carousel and Story containers cannot be trial posts.
Do followers see a trial reel?
Not at first. A trial reel is shared only with non-followers, and reaches followers once it graduates.
How long can a trial reel be?
The same as any reel: 3 seconds to 15 minutes, as an MOV or MP4 file of up to 300 MB at a public URL Meta can fetch.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on