Mentions

This edge allows you to create an IG Comment on an IG Comment or captioned IG Media object that an IG User has been @mentioned in by another Instagram user.

Creating

Replying to a Captioned IG Media Object

POST /{ig-user-id}/mentions?media_id={media_id}&message={message}

Creates an IG Comment on an IG Media object in which an IG User has been @mentioned in a caption.

Query String Parameters

Query string parameters are optional unless indicated as required.

  • {media_id} (required) — the media ID contained in the Webhook notification payload
  • {message} (required) — text to include in the commment

Permissions

A Facebook User access token with the following permissions:

  • instagram_basic
  • instagram_manage_comments
  • manage_pages or pages_show_list

If the token is from 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 cURL Request

curl -i -X POST \
 -d "media_id=17920112008063024" \
 -d "message=Thanks%20for%20the%20dinosaur!" \
 -d "access_token=a-valid-access-token-goes-here" \
 "https://graph.facebook.com/17841405309211844/mentions"

Sample Response

{
  "id": "17846319838228163"
}

Replying to a Comment

POST /{ig-user-id}/mentions?media_id={media_id}&comment_id={comment_id}&message={message}

Creates an IG Comment on an IG Comment in which an IG User has been @mentioned.

Query String Parameters

Query string parameters are optional unless indicated as required.

  • {comment_id} (required) — the comment ID contained in the Webhook notification payload
  • {media_id} (required) — the media ID contained in the Webhook notification payload
  • {message} (required) — text to include in the commment

Permissions

A Facebook User access token with the following permissions:

  • instagram_basic
  • instagram_manage_comments
  • manage_pages or pages_show_list

If the token is from 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

Parameters

  • comment_id (required)
  • media_id (required)
  • message

Sample cURL Request

curl -i -X POST \
 -d "media_id=17920112008063024" \
 -d "comment_id=17918718562020960" \
 -d "message=Hope%20you%20enjoy%20your%20new%20T-Rex!" \
 -d "access_token=a-valid-access-token-goes-here" \
 "https://graph.facebook.com/17841405309211844/mentions"

Sample Response

{
  "id": "17846319838254687"
}

Reading

This operation is not supported.

Updating

This operation is not supported.

Deleting

This operation is not supported.