Skip to content

Send private reply

Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: quickReplies (chips above the keyboard, max 13) or buttons (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Buttons are recommended for cold reach since chips do not render in the Instagram Message Requests folder. quickReplies and buttons are mutually exclusive.

POST /v1/inbox/comments/{postId}/{commentId}/private-reply

Send a private message to the author of a comment. Supported on Instagram and Facebook only. One reply per comment, must be sent within 7 days. Optionally attach interactive elements: quickReplies (chips above the keyboard, max 13) or buttons (1-3 inline postback/url buttons rendered in the same bubble via Meta's button_template). Buttons are recommended for cold reach since chips do not render in the Instagram Message Requests folder. quickReplies and buttons are mutually exclusive.

Parameters

  • postId (path, string) required — The media/post ID (Instagram media ID or Facebook post ID)

  • commentId (path, string) required — The comment ID to send a private reply to

Request body

Content-Type: application/json

  • accountId (string) required — The social account ID (Instagram or Facebook)
  • message (string) required — The message text to send as a private DM
  • quickReplies (array) — Optional quick-reply chips appended to the message. Visible only in the Instagram and Messenger apps (not on web). Maximum 13 entries. Mutually exclusive with buttons. Note: chips do NOT render in t...
  • buttons (array) — Optional 1-3 inline buttons rendered as part of the same message bubble via Meta's button_template. Visible in the Instagram Message Requests folder (unlike quick replies). Mutually exclusive with `qu...

Responses

200 — Private reply sent successfully

  • status (string)
  • messageId (string) — The ID of the sent message
  • commentId (string) — The comment ID that was replied to
  • platform (string) (enum: instagram, facebook)

400 — Bad request

  • error (string)
  • code (string) (enum: PLATFORM_LIMITATION)

401

403 — Inbox addon required

404 — Account not found