IG User Mentions

IGTV media is now supported in v10.0+. This applies to all endpoints except those used for content publishing and webhooks. To support this change, new media_product_type and video_title fields have been added to the IG Media node. IGTV media must have been shared to Instagram at the time of publish (Post a Preview or Share Preview to Feed enabled) in order to be accessible via the API.

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.

Limitations

  • Mentions on Stories are not supported.
  • Commenting on photos in which you were tagged is not supported.
  • Webhooks will not be sent if the Media upon which the comment or @mention appears was created by an account that is set to private.

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
  • pages_read_engagement
  • 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
  • pages_read_engagement
  • 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.

Limitations

  • Mentions on Stories are not supported.
  • Commenting on photos in which you were tagged is not supported.
  • Webhooks will not be sent if the Media upon which the comment or @mention appears was created by an account that is set to private.

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
  • pages_read_engagement
  • 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
  • pages_read_engagement
  • 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.