Collaboration

Updated: Apr 22, 2026

Collaboration Invites

You can list media collaboration invites from Instagram users. You are able to accept or decline a collaboration invite.

Fetch Collaboration Invites

Get a list of pending collaboration invites for an Instagram User. These invites are essentially Instagram Media objects (attributes) tagged for collaboration.

Each Media object (attributes) comprises Media ID, Media Owner Instagram Username, Media Caption and Media URL for an Instagram User

GET /<IG_USER_ID>/collaboration_invites

Limitations

Collaborator tagging supports Feed Image, Reels and Carousel objects.

Stories is not supported.

Rate limit applies to 300 calls per Instagram User per day (24 hours).

Requirements

Type	Description
Access Tokens	User – The Instagram User must be tagged for collaboration of Instagram Media(s) by other Instagram User(s).
Permissions	`instagram_basic`

Example Request

curl -i -X GET \
"https://graph.facebook.com/v23.0/<IG_USER_ID>/collaboration_invites?access_token=<USER-ACCESS-TOKEN>"

Sample Response

{
  "data": [
    {
      "media_id": "18078920227752107",
      "media_owner_username": "katrina",
      "caption": "Making memories all over the map",
      "media_url": "<media-url-1>"
    },
    {
      "media_id": "17938817952064413",
      "media_owner_username": "john",
      "caption": "Good vibes happen on the tides",
      "media_url": "<media-url-2>"
    },
    {
      "media_id": "17981928557731507",
      "media_owner_username": "amanda",
      "caption": "Less perfection, more authenticity",
      "media_url": "<media-url-3>"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIU000NzlGS3BndGdrTzgzb0xoNy1kXzljVGRDRFhlUTNQTjJZARTZAVWWlaQW1RcHN5WUZAtUXQzTnU3dEZAENnoxWkdtOWlaNDA0LXBUcDNXOG90dzR2WXJn",
      "after": "QVFIU1lic1ZAkRllCLTktY2wyUzdfb3VaWUdiNUF3TmRacWFaY1k1d2YweWZA4LXpsLUowcjVzaGl2cXljdmlNeG91bEVwVG93RnBKU3IwSW5Xdzh6MFhzZAUFn"
    }
  }
}

Path Parameters

Placeholder	Value
`<API_VERSION>`	API version.
`<IG_USER_ID>`Required string	The ID for your app user’s Instagram User.

Query String Parameters

Key	Placeholder	Value
`access_token` Required string	`<USER_ACCESS_TOKEN>`	Your app user’s User access token.
`limit` Optional int	`<LIMIT>` (eg. `15`)	Paging limit - Number of items returned in a paged response. Default is 10.
`after`Optional string	`<AFTER_CURSOR_STRING>`	Cursor string to iterate forwards from the current page
`before` Optional string	`<BEFORE_CURSOR_STRING>`	Cursor string to iterate backwards from the current page

Response Fields

Field Name	Description
`media_id`	The ID of the Instagram Media object tagged for collaboration
`media_owner_username`	The ID of the Instagram User who invited the app user’s Instagram account for collaboration
`caption`	Caption of the tagged Instagram Media
`media_url`	Viewable CDN URL of the tagged Instagram Media

Accept Or Decline Collaboration Invite

Accept or Decline a pending collaboration invite for an Instagram User for an Instagram post by other Instagram User(s).

Requires API params include API Version, Instagram User ID, invited Media ID and a boolean flag to indicate accept or decline.

POST /<IG_USER_ID>/collaboration_invites

Limitations

Accept/Decline collaborations supports Feed Image, Reels and Carousel objects.

Stories is not supported.

Rate limit applies to 50 calls per Instagram User per day (24 hours).

Requirements

Type	Description
Access Tokens	User – The Instagram User must be tagged for collaboration of Instagram Media(s) by other Instagram User(s).
Permissions	`instagram_basic`

Example Request

curl -i -X POST \
"https://graph.facebook.com/v23.0/<IG_USER_ID>/collaboration_invites?media_id=<IG_MEDIA_ID>&accept=true&access_token=<USER-ACCESS-TOKEN>

Sample Response

{
  "success": true
}

Path Parameters

Placeholder	Value
`<API_VERSION>`	API version.
`<IG_USER_ID>`Required string	The ID for your app user’s Instagram User.

Query String Parameters

Key	Placeholder	Value
`access_token`Required string	`<USER_ACCESS_TOKEN>`	Your app user’s User access token.
`media_id` Required string	`<IG_MEDIA_ID>`	The ID of the invited Instagram Media
`accept`Required boolean	`boolean`	Flag to accept/decline the invite. `true` to accept the invite `false` to decline the invite

Response Fields

Field Name	Description
`success`	Boolean flag to indicate whether the accept/decline succeeded

Collaborative Media

The Collaborative Media endpoints allow developers to retrieve media where an Instagram user is an accepted collaborator. This enables businesses and creators to track and measure the performance of collaborative content directly through the API.

Collaborative Media List

Retrieve a list of all media where the Instagram user is an accepted collaborator. This does not include media that the user owns directly — only media created by other users where the user has been added and accepted as a collaborator.

GET /<IG_USER_ID>/collaborative_media

Limitations

Collaborative media supports Feed Image, Reels and Carousel objects.

Stories is not supported.

You must be an accepted collaborator.

If the original media owner removes you as a collaborator, you can no longer access the media.

Requirements

Type	Description
Access Tokens	User
Permissions	`instagram_basic` — granted by one of the collaborators on the media.

Example Request

curl -i -X GET \
"https://graph.facebook.com/v23.0/<IG_USER_ID>/collaborative_media?fields=id,caption,media_type,timestamp,permalink,total_like_count,total_comments_count&access_token=<USER-ACCESS-TOKEN>"

Sample Response

{
  "data": [
    {
      "id": "17895695608903510",
      "caption": "Collab post with @Instagram",
      "media_type": "VIDEO",
      "timestamp": "2026-02-15T10:30:00+0000",
      "permalink": "https://www.instagram.com/reel/ABC123/",
      "total_like_count": 1502,
      "total_comments_count": 234
    }
  ],
  "paging": {
    "cursors": {
      "before": "...",
      "after": "..."
    },
    "next": "..."
  }
}

Path Parameters

Placeholder	Value
`<API_VERSION>`	API version.
`<IG_USER_ID>`Required string	The ID for your app user’s Instagram User.

Query String Parameters

Key	Placeholder	Value
`access_token` Required string	`<USER_ACCESS_TOKEN>`	Your app user’s User access token.
`fields` Optional string	`<FIELD_LIST>`	Comma-separated list of fields to return. See Supported Fields on Collaborative Media below.
`limit` Optional int	`<LIMIT>` (eg. `15`)	Paging limit.
`after`Optional string	`<AFTER_CURSOR_STRING>`	Cursor string to iterate forwards from the current page
`before` Optional string	`<BEFORE_CURSOR_STRING>`	Cursor string to iterate backwards from the current page

Collaborative Media Search

Look up a specific collaborative media by ID and retrieve its details. This is useful when you already know the media ID and want to fetch its data without paginating through all collaborative media.

GET /<IG_USER_ID>?fields=collaborative_media_search.media_id(<IG_MEDIA_ID>)

Notes

The specified media must not be owned by the requesting user. Use the standard GET /<IG_MEDIA_ID> endpoint for your own media.

The requesting user must be an accepted collaborator on the specified media.

Requirements

Type	Description
Access Tokens	User
Permissions	`instagram_basic` — granted by one of the collaborators on the media.

Example Request

curl -i -X GET \
"https://graph.facebook.com/v23.0/<IG_USER_ID>?fields=collaborative_media_search.media_id(17895695608903510){id,caption}&access_token=<USER-ACCESS-TOKEN>"

Sample Response

{
  "collaborative_media_search": {
    "id": "17895695608903510",
    "caption": "Collab post with @Instagram"
  },
  "id": "<IG_USER_ID>"
}

Path Parameters

Placeholder	Value
`<API_VERSION>`	API version.
`<IG_USER_ID>`Required string	The ID for your app user’s Instagram User.

Query String Parameters

Key	Placeholder	Value
`access_token`Required string	`<USER_ACCESS_TOKEN>`	Your app user’s User access token.
`fields` Required string	`collaborative_media_search.media_id(<IG_MEDIA_ID>)`	The media ID to look up. You can append `{field1,field2,...}` to select specific fields.

Supported Fields on Collaborative Media

The standard IG Media fields are available when accessing collaborative media through the GET /<IG_USER_ID>/collaborative_media and GET /<IG_USER_ID>?fields=collaborative_media_search.media_id(...) endpoints. This includes the following fields:

id

caption

comments_count

like_count

media_product_type

media_type

media_url

permalink

thumbnail_url

username

timestamp

total_like_count

total_comments_count

reposts_count

saved_count

shares_count

total_views_count

Limitations

These fields are not available for carousel child media. They are only returned for top-level media objects.

The media owner can disable showing likes, comments, views, reposts, and shares. In these cases, the corresponding fields are not returned.