IG User Media

• Create an image, carousel, story or reel IG Container for use in the post publishing process. See the Content Publishing guide for complete publishing steps.

1. Create a container
2. Upload the media to the container
3. Publish the container

• Containers expire after 24 hours
• An Instagram account can only create 400 containers within a rolling 24 hour period
• If the Page connected to the targeted Instagram professional account requires Page Publishing Authorization⁠ (PPA), PPA must be completed or the request will fail
• If the Page connected to the targeted Instagram professional account requires two-factor authentication, the Facebook User must also have performed two-factor authentication or the request will fail
• We strongly recommended the HTTP IETF standard character set for URLs, URLs that contain only US ASCII characters, or the request will fail

• Reels cannot appear in carousels
• Account privacy settings are respected upon publish. For example, if Allow remixing is enabled, published reels will have remixing enabled upon publish but remixing can be disabled on published reels manually through the Instagram app.
• Music tagging is only available for original audio.

• Stories expire after 24 hours.
• Support either video URL or Reels URL but not both.
• Publishing stickers (i.e., link, poll, location) is not supported; however mentioning users without a sticker is supported.

• Format: JPEG
• File size: 8 MB maximum.
• Aspect ratio: Must be within a 4:5 to 1.91:1 range
• Minimum width: 320 (will be scaled up to the minimum if necessary)
• Maximum width: 1440 (will be scaled down to the maximum if necessary)
• Height: Varies, depending on width and aspect ratio
• Color Space: sRGB. Images using other color spaces will have their color spaces converted to sRGB.

• Container: MOV or MP4 (MPEG-4 Part 14), no edit lists, moov atom at the front of the file.
• Audio codec: AAC, 48khz sample rate maximum, 1 or 2 channels (mono or stereo).
• Video codec: HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
• Frame rate: 23-60 FPS.
• Picture size:
  • Maximum columns (horizontal pixels): 1920
  • Required aspect ratio is between 0.01:1 and 10:1 but we recommend 9:16 to avoid cropping or blank space.
• Video bitrate: VBR, 25Mbps maximum
• Audio bitrate: 128kbps
• Duration: 15 mins maximum, 3 seconds minimum
• File size: 300MB maximum

• Format: JPEG
• File size: 8MB maximum
• Color Space: sRGB. Images that use other color spaces will be converted to sRGB.
• Aspect ratio: We recommend 9:16 to avoid cropping or blank space. If the aspect ratio of the original image is not 9:16, we crop the image and use the middle most 9:16 rectangle as the cover photo for the reel. If you share a reel to your feed, we crop the image and use the middle most 1:1 square as the cover photo for your feed post.

• Format: JPEG
• File size: 8 MB maximum.
• Aspect ratio: We recommended 9:16 to avoid cropping or blank space
• Color Space: sRGB. Images using other color spaces will have their color spaces converted to sRGB

• Container: MOV or MP4 (MPEG-4 Part 14), no edit lists, moov atom at the front of the file.
• Audio codec: AAC, 48khz sample rate maximum, 1 or 2 channels (mono or stereo).
• Video codec: HEVC or H264, progressive scan, closed GOP, 4:2:0 chroma subsampling.
• Frame rate: 23-60 FPS.
• Picture size:
  • Maximum columns (horizontal pixels): 1920
  • Required aspect ratio is between 0.1:1 and 10:1 but we recommend 9:16 to avoid cropping or blank space
• Video bitrate: VBR, 25Mbps maximum
• Audio bitrate: 128kbps
• Duration: 60 seconds maximum, 3 seconds minimum
• File size: 100MB maximum

POST https://graph.facebook.com/v26.0/<YOUR_APP_USERS_IG_USER_ID>/media
?image_url=<IMAGE_URL>
&is_carousel_item=<TRUE_OR_FALSE>
&alt_text=<IMAGE_ALTERNATIVE_TEXT>
&caption=<IMAGE_CAPTION>
&location_id=<LOCATION_PAGE_ID>
&user_tags=<ARRAY_OF_USERS_FOR_TAGGING>>
&product_tags=<ARRAY_OF_PRODUCTS_FOR_TAGGING>
&access_token=<USER_ACCESS_TOKEN>

Standard upload

POST https://graph.facebook.com/v26.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media
?media_type=REELS
&video_url=<REEL_URL>
&caption=<IMAGE_CAPTION>
&share_to_feed=<TRUE_OR_FALSE>
&collaborators=<COLLABORATOR_USERNAMES>
&cover_url=<COVER_URL>
&audio_name=<AUDIO_NAME>
&user_tags=<ARRAY_OF_USERS_FOR_TAGGING>>
&location_id=<LOCATION_PAGE_ID>
&thumb_offset=<THUMB_OFFSET>
&share_to_feed=<TRUE_OR_FALSE>
&trial_params=<TRIAL_PARAM>
&access_token=<USER_ACCESS_TOKEN>

Resumable upload session

POST https://graph.facebook.com/v26.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media
?media_type=REELS
&upload_type=resumable
&caption=<IMAGE_CAPTION>
&collaborators=<COLLABORATOR_USERNAMES>
&cover_url=<COVER_URL>
&audio_name=<AUDIO_NAME>
&user_tags=<ARRAY_OF_USERS_FOR_TAGGING>>
&location_id=<LOCATION_PAGE_ID>
&thumb_offset=<THUMB_OFFSET>
&access_token=<USER_ACCESS_TOKEN>

{
  "id": "<IG_CONTAINER_ID>",
  "uri": "https://rupload.facebook.com/ig-api-upload/v26.0/<IG_CONTAINER_ID>"
}

Standard upload

POST https://graph.facebook.com/v26.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media
?media_type=CAROUSEL
&caption=<IMAGE_CAPTION>
&share_to_feed=<TRUE_OR_FALSE>
&collaborators=<COLLABORATOR_USERNAMES>
&location_id=<LOCATION_PAGE_ID>
&product_tags=<ARRAY_OF_PRODUCTS_FOR_TAGGING>
&children=<ARRAY_OF_CAROUSEL_CONTAINTER_IDS>
&access_token=<USER_ACCESS_TOKEN>

Resumable upload session

POST https://graph.facebook.com/v26.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media
?media_type=VIDEO
&is_carousel_item=true
&upload_type=resumable
&access_token=<USER_ACCESS_TOKEN>

POST https://graph.facebook.com/v26.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media
?image_url=<IMAGE_URL>
&media_type=STORIES
&user_tags=<ARRAY_OF_USERS_FOR_TAGGING>
&access_token=<USER_ACCESS_TOKEN>

Standard upload

POST https://graph.facebook.com/v26.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media
?video_url=<VIDEO_URL>
&media_type=STORIES
&user_tags=<ARRAY_OF_USERS_FOR_TAGGING>
&access_token=<USER_ACCESS_TOKEN>

Resumable upload session

POST https://graph.facebook.com/v26.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media
?media_type=STORIES
&upload_type=resumable
&access_token=<USER_ACCESS_TOKEN>

• All media_type shares the same flow to upload the video.
• ig-container-id is the ID from the resumable reels, carousel and video container upload session examples above.
• access-token is the same one used in other steps.
• offset is set to the first byte being upload, generally 0.
• file_size is set to the size of your file in bytes.
• Your_file_local_path sets to the file path of your local file, for example, if uploading a file from the Downloads folder on macOS, the path is @Downloads/example.mov.

curl -X POST "https://rupload.facebook.com/ig-api-upload/v26.0/<IG_CONTAINER_ID>" \
     -H "Authorization: OAuth <USER_ACCESS_TOKEN>" \
     -H "offset: 0" \
     -H "file_size: Your_file_size_in_bytes" \
     --data-binary "@Your_local_file_path.extension"

{
  "success":true,
  "message":"Upload successful. ..."
}

curl -X POST "https://rupload.facebook.com/ig-api-upload/v26.0/<IG_CONTAINER_ID>" \
     -H "Authorization: OAuth <USER_ACCESS_TOKEN>" \
     -H "file_url: <VIDEO_URL>"

{
  "id":"<IG_CONTAINER_ID>"
}

POST graph.facebook.com/17841400008460056/media
  ?image_url=curls//www.example.com/images/bronzed-fonzes.jpg
  &caption=#BronzedFonzes!
  &collaborators= ['username1','username2']
  &user_tags=[
    {
      username:'kevinhart4real',
      x: 0.5,
      y: 0.8
    },
    {
      username:'therock',
      x: 0.3,
      y: 0.2
    }
  ]

{
  "id": "17889455560051444"
}

• Returns a maximum of 10K of the most recently created media.
• Story IG Media not supported, use the GET /<YOUR_APP_USERS_INSTAGRAM_USER_ID>/stories endpoint instead.

GET graph.facebook.com/v26.0/17841405822304914/media

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

• Error Codes