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

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

Query String Parameters

Response Fields

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

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

Query String Parameters

Response Fields