Content Publishing

• /<IG_ID>/media — Create media container and upload the media
  • upload_type=resumable — Create a resumbable upload session to upload large videos from an area with frequent network interruptions or other transmission failures. Only for apps that have implemented Facebook Login for Business.
• /<IG_ID>/media_publish — publish uploaded media using their media containers.
• /<IG_CONTAINER_ID>?fields=status_code — check media container publishing eligibility and status.
• /<IG_ID>/content_publishing_limit — check app user’s current publishing rate limit usage.
• POST https://rupload.facebook.com/ig-api-upload/<IG_MEDIA_CONTAINER_ID> — Upload the video to Meta servers
• GET /<IG_MEDIA_CONTAINER_ID>?fields=status_code — Check publishing eligibility and status of the video

• Some of the parameters are supported in list/dict format.
• Some characters need to be encoded into a format that can be transmitted over the Internet. For example: user_tags=[{username:'ig_user_name'}] is encoded to user_tags=%5B%7Busername:ig_user_name%7D%5D where [ is encoded to %5B and { is encoded to %7B. For more conversions, please refer to the HTML URL Encoding standard.

• JPEG is the only image format supported. Extended JPEG formats such as MPO and JPS are not supported.
• Shopping tags are not supported.
• Filters are not supported.

In order to publish a media object, it must have a container. To create the media container and upload a media file, send a POST request to the /<IG_ID>/media endpoint with the following parameters:

• access_token – Set to your app user’s access token
• image_url or video_url – Set to the path of the image or video. We will cURL your image using the passed in URL so it must be on a public server.
• media_type — If the container will be for a video, set to VIDEO, REELS, or STORIES.
• is_carousel_item – If the media will be part of a carousel, set to true
• upload_type – Set to resumable, if creating a resumable upload session for a large video file

Visit the Instagram User Media Endpoint Reference for additional optional parameters.

curl -X POST "https://<HOST_URL>/<LATEST_API_VERSION>/<IG_ID>/media"
     -H "Content-Type: application/json"
     -H "Authorization: Bearer <ACCESS_TOKEN>"
     -d '{
           "image_url":"https://www.example.com/images/bronz-fonz.jpg"
         }'

{
  "id": "<IG_CONTAINER_ID>"
}

To publish up to 10 images, videos, or a combination of the two, in a single post, a carousel post, you must create a carousel container. This carousel containter will contain a list of all media containers.

To create the carousel container, send a POST request to the /<IG_ID>/media endpoint with the following parameters:

• media_type — Set to CAROUSEL. Indicates that the container is for a carousel.
• children — A comma separated list of up to 10 container IDs of each image and video that should appear in the published carousel.

• Carousels are limited to 10 images, videos, or a mix of the two.
• Carousel images are all cropped based on the first image in the carousel, with the default being a 1:1 aspect ratio.
• Accounts are limited to 50 published posts within a 24-hour period. Publishing a carousel counts as a single post.

curl -X POST "https://graph.instagram.com/v25.0/90010177253934/media"
     -H "Content-Type: application/json"
     -d '{
           "caption":"Fruit%20candies"
           "media_type":"CAROUSEL"
           "children":"<IG_CONTAINER_ID_1>,<IG_CONTAINER_ID_2>,<IG_CONTAINER_ID_3>"
         }'

{
  "id": "<IG_CAROUSEL_CONTAINER_ID>"
}

• A file located on your computer
• A file hosted on a public facing server, such as a CDN

• access_token *

• Be sure the host is rupload.facebook.com.
• All media_type shares the same flow to upload the video.
• ig-container-id is the ID returned from resumable upload session calls.
• access-token is the same one used in previous 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 is set 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/<API_VERSION>/<IG_MEDIA_CONTAINER_ID>`" \
     -H "Authorization: OAuth <ACCESS_TOKEN>" \
     -H "offset: 0" \
     -H "file_size: Your_file_size_in_bytes" \
     --data-binary "@my_video_file.mp4"

curl -X POST "https://rupload.facebook.com/ig-api-upload/<API_VERSION>/<IG_MEDIA_CONTAINER_ID>`" \
     -H "Authorization: OAuth <ACCESS_TOKEN>" \
     -H "file_url: https://example_hosted_video.com"

// Success Response Message
{
  "success":true,
  "message":"Upload successful."
}

// Failure Response Message
{
  "debug_info":{
    "retriable":false,
    "type":"ProcessingFailedError",
    "message":"{\"success\":false,\"error\":{\"message\":\"unauthorized user request\"}}"
  }
}

• creation_id set to the container ID, either for a single media container or a carousel container

curl -X POST "https://<HOST_URL>/<LATEST_API_VERSION>/<IG_ID>/media_publish"
     -H "Content-Type: application/json"
     -H "Authorization: Bearer <ACCESS_TOKEN>"
     -d '{
           "creation_id":"<IG_CONTAINER_ID>"
         }'

{
  "id": "<IG_MEDIA_ID>"
}

curl -X POST "https://graph.instagram.com/v25.0/90010177253934/media"
     -H "Content-Type: application/json"
     -d '{
           "media_type":"REELS"
           "video_url":"https://www.example.com/videos/bronz-fonz.mp4"
           "trial_params":{
             "graduation_strategy": "MANUAL"
           }
         }'

curl -X POST "https://graph.facebook.com/<LATEST_API_VERSION>/<IG_USER_ID>/media" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -d "image_url=<IMAGE_URL>" \
     -d "caption=<CAPTION>" \
     -d "is_ai_generated=true"

• Your app user’s access token must include the instagram_branded_content_creator or instagram_basic permission.
• Sponsor accounts must be professional accounts.
• Maximum 2 sponsor tags per post.
• Not supported on close-friends-only posts or remixed media.
• This is available for Instagram API with Facebook Login only

curl -X POST "https://graph.facebook.com/<LATEST_API_VERSION>/<IG_USER_ID>/media" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -d "image_url=<IMAGE_URL>" \
     -d "caption=<CAPTION>" \
     -d "branded_content_sponsor_ids=[<BRAND_IG_USER_ID1>, <BRAND_IG_USER_ID2>]" \
     -d "is_paid_partnership=true"

• EXPIRED — The container was not published within 24 hours and has expired.
• ERROR — The container failed to complete the publishing process.
• FINISHED — The container and its media object are ready to be published.
• IN_PROGRESS — The container is still in the publishing process.
• PUBLISHED — The container’s media object has been published.