Instagram mentions through the API: finding and replying to @mentions
Instagram's API reports @mentions of a professional account in comments and captions on public media, and lets the account reply in place. With Instagram Login, mentions arrive on the comments webhook, and the reply goes through POST /<IG_ID>/mentions with the media ID, plus the comment ID for a comment, posting as a comment there.
easyCoexistence forwards the Instagram account's comments, mentions and DMs to your endpoint as they arrive, signed with a secret for that account, once you set it with set_social_webhook_destination.
Webhook notification that includes mentions for apps using Instagram Login.
Endpoint that replies to a comment or caption in which another Instagram user @mentioned the account.
Media owned by a private account triggers no webhook for a comment or @mention on it.
Permissions mentions need with Instagram Login: instagram_business_basic and instagram_business_manage_comments.
How do mentions arrive?
By webhook, as they happen. With Instagram Login, Meta includes mentions in the comments notification rather than sending a separate mentions field, so a handler reads them from the same events as new comments. Meta keeps no history of past notifications, so store what you need from each one when it arrives.
Which mentions does the API cover?
Meta's mentions API identifies captions, comments and media in which a business or creator account has been @mentioned or tagged:
- @mentions in comments.
- @mentions in the caption of a post.
- Media the account is tagged in, listed by GET /<
IG_ID>/tags; commenting on photos the account is only tagged in is not supported. - Not Stories: the mentions API does not support them, and a Story mention reaches the account as a DM whose attachment type is
story_mention. - Not private accounts: media they own sends no mention webhooks.
How do you reply to a mention?
With POST /<IG_ID>/mentions. For a mention in a comment, send media_id and comment_id with the message, and the reply appears in that comment's thread; for a mention in a caption, send media_id and the message, and it posts as a comment on the media. Both IDs come from the webhook notification.
POST https://graph.instagram.com/<IG_ID>/mentions
?media_id=<MEDIA_ID>
&comment_id=<COMMENT_ID>
&message=<REPLY_TEXT>What do mentions need?
With Instagram Login, the permissions instagram_business_basic and instagram_business_manage_comments, the same pair comment moderation uses, with calls going to graph.instagram.com. To serve professional accounts the developer does not own or manage, the app also needs Advanced Access.
Common mistakes
- Waiting for a separate mentions event under Instagram Login. Meta delivers mentions inside the comments notification.
- Replying to a mention on another account's post like a comment on your own. Meta's route for it is POST /<IG_ID>/mentions, with the media ID and, for a comment, the comment ID.
- Expecting Story mentions from the mentions API. Meta does not support them there; they reach the account as DMs.
- Counting on the webhook to replay old mentions. Meta keeps no notification history, so store each one as it arrives.
Its tools reply to comments on your own posts with reply_to_comment; answering a mention on someone else's post, which uses Meta's mentions endpoint, is not among them. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Can I comment on a photo my account is tagged in?
No. GET /<IG_ID>/tags lists the media the account is tagged in, but Meta does not support commenting on photos the account is only tagged in.
Can I reply to a mention on someone else's post?
Yes. POST /<IG_ID>/mentions with the media ID, and the comment ID when the mention is in a comment, posts the reply there as the account.
Are Story mentions available through the mentions API?
No. A Story mention reaches the account as a DM whose attachment type is story_mention, and can get a reply in that conversation.
Why did a mention never arrive?
The media may belong to a private account, which sends no mention notifications, or the mention may be in a Story, which the mentions API does not cover.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on