Instagram (IG) Container

Updated: Jul 23, 2024

Represents a media container for publishing an Instagram media object.

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User user access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic` `instagram_business_content_publish`	`instagram_basic` `instagram_content_publish` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read`

Creating

This operation is not supported.

GET <HOST_URL>/<IG_CONTAINER_ID>

Get fields and edges on an IG Container.

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parameter	Value
`access_token` Required String	The app user’s User access token.
`fields` Comma-separated list	A comma-separated list of fields and edges you want returned. If omitted, default fields will be returned.

Field Name	Description
`copyright_check_status`	Used to determine if an uploaded video is violating copyright. Key-values pairs return include: `matches_found` set to one of the following: `true` – the video is violating copyright `false` – the video is not violating copyright `status` set to one of the following: `completed` – the detection process has finished `error` – an error occurred during the detection process `in_progress` – the detection process is ongoing `not_started` – the detection process has not started
`id`	Instagram Container ID, represented in code examples as `<IG_CONTAINER_ID>`
`status`	Publishing status. If `status_code` is `ERROR`, this value will be an error subcode.
`status_code`	The container’s publishing status. Possible values: `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.

There are no edges on this node.

A JSON-formatted object containing default and requested fields.

{
  "<FIELD>":"<VALUE>",
  ...
}

curl -X GET \
  'https://graph.instagram.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

This operation is not supported.

This operation is not supported.