Setting a Reel's cover image through the Instagram API
Instagram's API sets a Reel's cover in one of two ways when the container is created: cover_url points at a JPEG image to use as the Reels tab cover, or thumb_offset picks a frame of the video, in milliseconds from the start. With neither, the first frame is used, and when both are sent, cover_url wins.
easyCoexistence publishes Reels with publish_instagram_post from Claude, ChatGPT or your own code.
Largest Reels cover image; it must be a JPEG, and other color spaces are converted to sRGB.
Cover shape Meta recommends; other shapes are cropped to their middle 9:16 rectangle.
The middle square Meta crops from the cover when the Reel is shared to the Feed.
Default thumb_offset, which makes the video's first frame the thumbnail.
Error subcode for a thumb_offset below 0 or not shorter than the video's duration.
How do you set a Reel's cover?
On the Reel's container. POST /<IG_ID>/media with media_type REELS and video_url also takes either cover_url, the public URL of an image Meta fetches and uses as the Reels tab cover, or thumb_offset, the position in milliseconds of the frame to use. The cover belongs to the container, so it is chosen before the Reel is published.
POST https://graph.instagram.com/<IG_ID>/media
Content-Type: application/json
{
"media_type": "REELS",
"video_url": "https://example.com/reel.mp4",
"caption": "<CAPTION>",
"cover_url": "https://example.com/cover.jpg"
}What does the cover image have to be?
Meta's specification for a Reels cover photo, which the image at cover_url has to meet:
- Format: JPEG.
- File size: up to 8 MB.
- Color space: sRGB; images in other color spaces are converted.
- Aspect ratio: 9:16 recommended, to avoid cropping or blank space.
- Location: a public server, since Meta fetches the image from the URL itself.
How is the cover cropped?
Around the middle. When the image is not 9:16, Meta crops it and uses the middle 9:16 rectangle as the Reel's cover, and when the Reel is shared to the Feed, the middle 1:1 square becomes the cover of the Feed post. Keeping faces and text near the center lets both crops show them.
How does thumb_offset work?
It names a moment in the video, in milliseconds, whose frame becomes the thumbnail; the default, 0, is the first frame. The value must be 0 or more and less than the video's duration, or the request fails with code 1, subcode 2207057. thumb_offset applies to video containers too, and on a Reel that also has cover_url, Meta ignores it.
Can the cover be read back or changed later?
Read back, yes: a published Reel reports media_type VIDEO, and its thumbnail_url field returns the media's thumbnail image. Changing it is another matter, since the only update Meta documents for published media turns comments on or off, so the cover is settled when the container is created.
Common mistakes
- Sending cover_url and thumb_offset together and expecting the frame. Meta uses cover_url and ignores thumb_offset.
- Giving thumb_offset in seconds. It counts milliseconds, and a value at or past the video's length fails with subcode 2207057.
- Uploading a PNG cover. A Reels cover must be a JPEG of up to 8 MB.
- Placing the subject at the edge of the cover. Meta keeps the middle 9:16 of the image, and only the middle square in the Feed.
The tool takes no cover_url or thumb_offset, so the Reel goes out with the frame Instagram picks, and another cover is chosen in the Instagram app. 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 I upload a custom cover for a Reel through the API?
Yes. Pass cover_url with the public URL of a JPEG of up to 8 MB when creating the Reel's container.
Does a Reel cover have to be sRGB?
It should be. Meta's specification asks for sRGB and converts images in other color spaces, and the cover has to be a JPEG of up to 8 MB.
What does error 2207057 mean on an Instagram Reel?
The Reel's thumb_offset is out of range, under code 1: it must be at least 0 and less than the video's duration, counted in milliseconds, so 5 seconds in is 5000.
What if I send both cover_url and thumb_offset?
Meta uses the cover_url image and ignores thumb_offset.
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