---
title: "Reply to a mention"
method: POST
path: "/v1/inbox/mentions/reply"
tags: ["Mentions"]
---

# Reply to a mention

`POST /v1/inbox/mentions/reply`

Reply to a mention of the connected account. Supported on Instagram only.

Two shapes, selected by whether `commentId` is present:

- **Comment mention** (someone @mentioned the account inside a comment): pass both
  `mediaId` and `commentId`. Instagram posts a reply under that comment.
- **Caption mention** (someone @mentioned the account in their media caption, so no
  comment exists): pass `mediaId` only. Instagram posts a comment on their media.

Story mentions are not supported by Instagram's API.

Note that `GET /v1/inbox/mentions` currently returns LinkedIn mentions only and does
not surface Instagram mentions. Source `mediaId` and `commentId` from Instagram's
`comments` webhook, which is where mention notifications are delivered for accounts
connected through Instagram Login.

## Request body

- object
  - `accountId` string, required — The Instagram social account ID
  - `mediaId` string, required — The ID of the media the account was mentioned in
  - `commentId` string — The mentioning comment's ID. Omit for a caption mention.
  - `message` string, required — The reply text

## Response `200`

Reply posted

- object
  - `success` boolean
  - `id` string — ID of the created reply or comment

## Other responses

- `400` — Platform does not support replying to mentions (code: platform_not_supported), or missing mediaId/message.
- `401` — Unauthorized
- `403` — Inbox addon required
- `404` — Account not found
- `502` — Instagram was unreachable or returned an unclassified error. Instagram 4xx statuses are forwarded as-is.

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/51932b099b2f/schema)