Instagram Platform API account IDs will not work with the new Instagram Graph API. Please use the Page node to determine the correct Instagram Business Account ID associated with the Facebook page.

Media

This edge allow you to:

Creating

Creating Media Object Containers

This operation is only available to partners in the Content Publishing API beta program.

To create a media object container, send a POST request to the /user/media edge and include the following parameters:

  • image_url — (required) The path to the photo.
  • caption — (optional) A caption for the photo. Like the app, you can include hashtags (e.g., #crazywildebeest) and usernames of Instagram Users (e.g., @natgeo). @Mentioned Users will receive a notification when you publish the media object container.

If successful, this edge will respond with the newly created media object container's id. You can then use the id to publish the media object container. If you don't publish the media object container within 24 hours, it will expire.

Permissions

A User access token with the following permissions:

  • instagram_basic
  • instagram_content_publish

Sample Request

POST graph.facebook.com 
  /17841400008460056/media?
    image_url=https%3A%2F%2Fwww.example.com%2Fimages%2Fbronz-fonz.jpg&
    caption=%23BronzFonz%20for%20the%20win!

Sample Response

{
  "id": "17889455560051444"
}

Reading

Getting Media Objects

To get all media objects for an Instagram Business Account, send a GET request to the /user/media edge.

Permissions

A User access token with the following permissions:

  • instagram_basic

If the token is for a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

  • ads_management
  • manage_pages
  • business_management

Sample Request

GET graph.facebook.com
  /17841405822304914/media

Sample Response

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

Updating

This operation is not supported.

Deleting

This operation is not supported.