Mentions - HookMyApp

How mentions reach you

A mention arrives at your webhook as a comments event. There is no separate mentions payload to handle, and your channel is already subscribed; nothing extra to set up. See Receive webhooks. Whether the mention was in a caption or a comment, the notification carries the ids the reply call needs.

See what you were tagged in

curl "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}/tags?fields=id,caption,media_type,media_url,permalink,timestamp,username" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

Returns the posts by other accounts that tagged you, newest first, paginated.

Reply to the mention

# Reply to a caption mention
curl -X POST "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}/mentions" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ "media_id": "'"${MEDIA_ID}"'", "message": "thanks for the shout-out" }'

# Reply to a comment mention: media_id AND comment_id
curl -X POST "https://gateway.hookmyapp.com/meta/v25.0/${INSTAGRAM_ACCOUNT_ID}/mentions" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{ "media_id": "'"${MEDIA_ID}"'", "comment_id": "'"${COMMENT_ID}"'", "message": "thanks!" }'

The reply posts as a public comment from your account. Both shapes need media_id, even when replying to a comment. Mentions in stories cannot be replied to, and neither can photos you were tagged in.

Mentions with the CLI

# See the posts that tagged you
hookmyapp instagram media --channel @your-handle --source tagged

# Reply to a caption mention
hookmyapp instagram mentions --channel @your-handle --media <media-id> --reply "thanks for the shout-out"

# Reply to a comment mention
hookmyapp instagram mentions --channel @your-handle --media <media-id> --comment <comment-id> --reply "thanks!"

Mentions with MCP

list_instagram_media with source tagged shows what tagged you; reply_instagram_mention posts the reply.

Use HookMyApp MCP to read the Instagram mention from this webhook and reply if it sounds like a genuine compliment.

Next steps

Receive webhooks: comment mentions arrive in your comments events.
Comments: reply publicly, reply privately, hide, or delete.
Your posts and profile: posts you were tagged in, which you can list.