Inbox
Unified inbox: direct messages, comments, reviews and mentions across networks, plus messaging settings, X engagement and Reddit discovery.
Conversations
List conversations
/inbox/conversationsDirect-message conversations of every connected account the caller can see, newest activity first. Filter by profile, account, platform, status, folder (message requests), assignee, label or unread.
Try it with MCPAsk your agent to call list-conversations (toolset inbox)Set up MCP
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringlast_message_atcreated_atunread_count
orderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
profile_idstringOnly items of this profile (pro_…)
account_idstringOnly items of this account (sa_…)
platformstringfacebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta
statusstringopenactivearchivedsnoozed
folderstringinboxrequests
assignee_idstringusr_… or "none" for unassigned
labelstringunreadbooleanqstringParticipant name / username contains
≤ 200 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 25 item attributes
objectstringconversation
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringparticipantobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_groupbooleanfolderstringinboxrequests
statusstringopenarchivedsnoozed
snoozed_untilstring (date-time) | nullunread_countintegerassignee_idstring | nulllabelsarray of stringthread_ownerstring | nullcontact_idstring | nulllast_message_previewstring | nulllast_message_directionstring | nullinboundoutbound
last_message_atstring (date-time) | nulllast_inbound_atstring (date-time) | nullurlstring | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Start a conversation
/inbox/conversationsOpen a direct-message thread with a user (X, Bluesky, Reddit, Discord, Mastodon). If a thread with that participant exists, the message is added to it.
Try it with MCPAsk your agent to call create-conversation (toolset inbox)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringrequiredAccount id (sa_…)
1–80 characters
participant_idstring1–300 characters
participant_usernamestring1–300 characters
textstring1–20000 characters
media_idsarray of string≤ 10 items
attachment_urlstring (uri)attachment_typestringimagevideoaudiofile
skip_dm_checkbooleantemplateobjectShow 7 child attributes
namestringrequired≥ 1 characters
languagestringparamsarray of stringbutton_paramsarray of objectcardsarray of objectheader_mediaobjectheader_locationobjectcategorystringutilitymarketingauthentication
link_previewbooleanReturns object
objectstringconversation
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringparticipantobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_groupbooleanfolderstringinboxrequests
statusstringopenarchivedsnoozed
snoozed_untilstring (date-time) | nullunread_countintegerassignee_idstring | nulllabelsarray of stringthread_ownerstring | nullcontact_idstring | nulllast_message_previewstring | nulllast_message_directionstring | nullinboundoutbound
last_message_atstring (date-time) | nulllast_inbound_atstring (date-time) | nullurlstring | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullsent_messageobject | nullResponses
Search conversations
/inbox/conversations/searchSearch message text and participant identity (name, username, id). Each result carries up to 3 matching messages, most recent match first.
Try it with MCPAsk your agent to call search-conversations (toolset inbox)Set up MCP
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringorderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
profile_idstringOnly items of this profile (pro_…)
account_idstringOnly items of this account (sa_…)
platformstringfacebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta
qstringText to search in messages and participant identity
1–200 characters
querystringAlias of q (Zernio)
1–200 characters
directionstringinboundoutboundincomingoutgoing
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
objectstringconversation_search_result
conversationobjectShow 25 child attributes
objectstringconversation
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringparticipantobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_groupbooleanfolderstringinboxrequests
statusstringopenarchivedsnoozed
snoozed_untilstring (date-time) | nullunread_countintegerassignee_idstring | nulllabelsarray of stringthread_ownerstring | nullcontact_idstring | nulllast_message_previewstring | nulllast_message_directionstring | nullinboundoutbound
last_message_atstring (date-time) | nulllast_inbound_atstring (date-time) | nullurlstring | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullmatch_countintegermatchesarray of objectShow 4 item attributes
idstringtextstring | nulldirectionstringinboundoutbound
sent_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Get a conversation
/inbox/conversations/{conversationId}Try it with MCPAsk your agent to call get-conversation (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…)
1–80 characters
Returns object
objectstringconversation
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringparticipantobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_groupbooleanfolderstringinboxrequests
statusstringopenarchivedsnoozed
snoozed_untilstring (date-time) | nullunread_countintegerassignee_idstring | nulllabelsarray of stringthread_ownerstring | nullcontact_idstring | nulllast_message_previewstring | nulllast_message_directionstring | nullinboundoutbound
last_message_atstring (date-time) | nulllast_inbound_atstring (date-time) | nullurlstring | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Update a conversation
/inbox/conversations/{conversationId}Archive, reopen or snooze a conversation, assign it to a workspace member, set labels or link a contact.
Try it with MCPAsk your agent to call update-conversation (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…)
1–80 characters
Body object
statusstringopenactivearchivedsnoozed
snoozed_untilstring (date-time) | nullassignee_idstring | nulllabelsarray of string≤ 20 items
contact_idstring | nullaccount_idstringIgnored (Zernio compatibility)
Returns object
objectstringconversation
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringparticipantobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_groupbooleanfolderstringinboxrequests
statusstringopenarchivedsnoozed
snoozed_untilstring (date-time) | nullunread_countintegerassignee_idstring | nulllabelsarray of stringthread_ownerstring | nullcontact_idstring | nulllast_message_previewstring | nulllast_message_directionstring | nullinboundoutbound
last_message_atstring (date-time) | nulllast_inbound_atstring (date-time) | nullurlstring | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Accept a message request
/inbox/conversations/{conversationId}/acceptAccept a Facebook / Instagram (or Bluesky) message request by replying to it; the thread moves to the inbox folder.
Try it with MCPAsk your agent to call accept-conversation (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired1–20000 characters
account_idstringReturns object
objectstringmessage
idstringconversation_idstringaccount_idstring | nullplatformstring | nullexternal_idstring | nulldirectionstringinboundoutbound
textstring | nullsenderobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullattachmentsarray of objectShow 9 item attributes
indexintegertypestringurlstring | nullmime_typestring | nullfilenamestring | nullsizeinteger | nullpreview_urlstring | nullmedia_idstring | nullrefresh_urlstring | nullstatusstringerrorobject | nullShow 2 child attributes
codestring | nullmessagestring | nullreactionsarray of objectShow 4 item attributes
emojistringfrom_mebooleansender_idstring | nullreacted_atstring (date-time) | nullreply_to_idstring | nullreply_to_external_idstring | nullis_editedbooleanedited_atstring (date-time) | nulledit_countintegeredit_historyarray of objectShow 2 item attributes
textstring | nulledited_atstring (date-time) | nullis_deletedbooleandeleted_atstring (date-time) | nullsent_viastring | nullsent_by_user_idstring | nullsent_atstring (date-time) | nulldelivered_atstring (date-time) | nullread_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Mark a conversation as read
/inbox/conversations/{conversationId}/readMarks every unread inbound message as read and sends read receipts where the network supports them (Messenger, Instagram, Bluesky, TikTok, Reddit, Mastodon).
Try it with MCPAsk your agent to call mark-conversation-read (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringReturns object
objectstringconversation
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringparticipantobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_groupbooleanfolderstringinboxrequests
statusstringopenarchivedsnoozed
snoozed_untilstring (date-time) | nullunread_countintegerassignee_idstring | nulllabelsarray of stringthread_ownerstring | nullcontact_idstring | nulllast_message_previewstring | nulllast_message_directionstring | nullinboundoutbound
last_message_atstring (date-time) | nulllast_inbound_atstring (date-time) | nullurlstring | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Mark a conversation as unread
/inbox/conversations/{conversationId}/unreadFlags the conversation unread in Socialit (no network call).
Try it with MCPAsk your agent to call mark-conversation-unread (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringconversation
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringparticipantobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_groupbooleanfolderstringinboxrequests
statusstringopenarchivedsnoozed
snoozed_untilstring (date-time) | nullunread_countintegerassignee_idstring | nulllabelsarray of stringthread_ownerstring | nullcontact_idstring | nulllast_message_previewstring | nulllast_message_directionstring | nullinboundoutbound
last_message_atstring (date-time) | nulllast_inbound_atstring (date-time) | nullurlstring | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Send a typing indicator
/inbox/conversations/{conversationId}/typingTry it with MCPAsk your agent to call send-typing-indicator (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringReturns object
objectstringtyping_indicator
conversation_idstringsentbooleanResponses
Change who answers a conversation
/inbox/conversations/{conversationId}/thread-controlMeta's handover protocol: take, pass, release or request thread control.
Try it with MCPAsk your agent to call change-thread-control (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
actionstringrequiredreleasetakepassrequest
targetstringai_agent
target_app_idstring≤ 100 characters
metadatastring≤ 1000 characters
account_idstringReturns object
objectstringthread_control
conversation_idstringownerstring | nullowner_app_idstring | nullResponses
List messages
/inbox/conversations/{conversationId}/messagesMessages of a conversation, oldest first by default (order=desc for the latest). refresh=true pulls the newest messages from the network first.
Try it with MCPAsk your agent to call list-messages (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…)
1–80 characters
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringsent_at
orderstringdefault: "asc"ascdesc
matchstringCombine filters with AND (default) or OR
allor
directionstringinboundoutbound
refreshbooleandefault: falsePull the latest messages from the network first
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 29 item attributes
objectstringmessage
idstringconversation_idstringaccount_idstring | nullplatformstring | nullexternal_idstring | nulldirectionstringinboundoutbound
textstring | nullsenderobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullattachmentsarray of objectShow 9 item attributes
indexintegertypestringurlstring | nullmime_typestring | nullfilenamestring | nullsizeinteger | nullpreview_urlstring | nullmedia_idstring | nullrefresh_urlstring | nullstatusstringerrorobject | nullShow 2 child attributes
codestring | nullmessagestring | nullreactionsarray of objectShow 4 item attributes
emojistringfrom_mebooleansender_idstring | nullreacted_atstring (date-time) | nullreply_to_idstring | nullreply_to_external_idstring | nullis_editedbooleanedited_atstring (date-time) | nulledit_countintegeredit_historyarray of objectShow 2 item attributes
textstring | nulledited_atstring (date-time) | nullis_deletedbooleandeleted_atstring (date-time) | nullsent_viastring | nullsent_by_user_idstring | nullsent_atstring (date-time) | nulldelivered_atstring (date-time) | nullread_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Send a message
/inbox/conversations/{conversationId}/messagesSend text, media (media_ids from the media library or a public attachment_url), quick replies, buttons, templates, interactive messages, locations or contacts. Support varies by network.
Try it with MCPAsk your agent to call send-message (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredConversation id (conv_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstring1–20000 characters
media_idsarray of string≤ 10 items
attachment_urlstring (uri)attachment_typestringimagevideoaudiofile
attachment_namestring≤ 255 characters
quick_repliesarray of object≤ 13 items
Show 3 item attributes
titlestringrequired1–20 characters
payloadstringrequired≤ 1000 characters
image_urlstringbuttonsarray of object≤ 3 items
Show 5 item attributes
typestringrequiredurlpostbackphone
titlestringrequired1–20 characters
urlstringpayloadstringphonestringtemplateobjectmessaging_typestringRESPONSEUPDATEMESSAGE_TAG
message_tagstringCONFIRMED_EVENT_UPDATEPOST_PURCHASE_UPDATEACCOUNT_UPDATEHUMAN_AGENT
reply_tostring≤ 300 characters
subjectstring≤ 300 characters
account_idstringIgnored (Zernio compatibility)
Returns object
objectstringmessage
idstringconversation_idstringaccount_idstring | nullplatformstring | nullexternal_idstring | nulldirectionstringinboundoutbound
textstring | nullsenderobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullattachmentsarray of objectShow 9 item attributes
indexintegertypestringurlstring | nullmime_typestring | nullfilenamestring | nullsizeinteger | nullpreview_urlstring | nullmedia_idstring | nullrefresh_urlstring | nullstatusstringerrorobject | nullShow 2 child attributes
codestring | nullmessagestring | nullreactionsarray of objectShow 4 item attributes
emojistringfrom_mebooleansender_idstring | nullreacted_atstring (date-time) | nullreply_to_idstring | nullreply_to_external_idstring | nullis_editedbooleanedited_atstring (date-time) | nulledit_countintegeredit_historyarray of objectShow 2 item attributes
textstring | nulledited_atstring (date-time) | nullis_deletedbooleandeleted_atstring (date-time) | nullsent_viastring | nullsent_by_user_idstring | nullsent_atstring (date-time) | nulldelivered_atstring (date-time) | nullread_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Delete a message
/inbox/conversations/{conversationId}/messages/{messageId}Delete / unsend a message (X, Bluesky for self, Reddit).
Try it with MCPAsk your agent to call delete-message (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredconversation id (conv_…)
1–80 characters
messageIdstringrequiredMessage id (msg_…) or the network message id
1–500 characters
Returns object
objectstringrequiredmessage
idstringrequireddeletedbooleanrequiredResponses
React to a message
/inbox/conversations/{conversationId}/messages/{messageId}/reactionsTry it with MCPAsk your agent to call add-message-reaction (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredconversation id (conv_…)
1–80 characters
messageIdstringrequiredMessage id (msg_…) or the network message id
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
emojistringrequired1–64 characters
account_idstringReturns object
objectstringmessage
idstringconversation_idstringaccount_idstring | nullplatformstring | nullexternal_idstring | nulldirectionstringinboundoutbound
textstring | nullsenderobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullattachmentsarray of objectShow 9 item attributes
indexintegertypestringurlstring | nullmime_typestring | nullfilenamestring | nullsizeinteger | nullpreview_urlstring | nullmedia_idstring | nullrefresh_urlstring | nullstatusstringerrorobject | nullShow 2 child attributes
codestring | nullmessagestring | nullreactionsarray of objectShow 4 item attributes
emojistringfrom_mebooleansender_idstring | nullreacted_atstring (date-time) | nullreply_to_idstring | nullreply_to_external_idstring | nullis_editedbooleanedited_atstring (date-time) | nulledit_countintegeredit_historyarray of objectShow 2 item attributes
textstring | nulledited_atstring (date-time) | nullis_deletedbooleandeleted_atstring (date-time) | nullsent_viastring | nullsent_by_user_idstring | nullsent_atstring (date-time) | nulldelivered_atstring (date-time) | nullread_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Remove a reaction
/inbox/conversations/{conversationId}/messages/{messageId}/reactionsTry it with MCPAsk your agent to call remove-message-reaction (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredconversation id (conv_…)
1–80 characters
messageIdstringrequiredMessage id (msg_…) or the network message id
1–500 characters
Query parameters
emojistring≤ 64 characters
account_idstringReturns object
objectstringmessage
idstringconversation_idstringaccount_idstring | nullplatformstring | nullexternal_idstring | nulldirectionstringinboundoutbound
textstring | nullsenderobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullattachmentsarray of objectShow 9 item attributes
indexintegertypestringurlstring | nullmime_typestring | nullfilenamestring | nullsizeinteger | nullpreview_urlstring | nullmedia_idstring | nullrefresh_urlstring | nullstatusstringerrorobject | nullShow 2 child attributes
codestring | nullmessagestring | nullreactionsarray of objectShow 4 item attributes
emojistringfrom_mebooleansender_idstring | nullreacted_atstring (date-time) | nullreply_to_idstring | nullreply_to_external_idstring | nullis_editedbooleanedited_atstring (date-time) | nulledit_countintegeredit_historyarray of objectShow 2 item attributes
textstring | nulledited_atstring (date-time) | nullis_deletedbooleandeleted_atstring (date-time) | nullsent_viastring | nullsent_by_user_idstring | nullsent_atstring (date-time) | nulldelivered_atstring (date-time) | nullread_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Resolve a message attachment
/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}A media URL that works now: re-mints expired Instagram / Messenger URLs, downloads X DM media. format=redirect (default) answers 302; format=json returns the URL.
Try it with MCPAsk your agent to call get-message-attachment (toolset inbox)Set up MCP
Path parameters
conversationIdstringrequiredconversation id (conv_…)
1–80 characters
messageIdstringrequiredMessage id
1–500 characters
indexintegerrequired0–50
Query parameters
formatstringdefault: "redirect"redirectjson
account_idstringReturns object
objectstringmessage_attachment
message_idstringindexintegertypestringurlstring | nullmime_typestring | nullrefreshedbooleanResponses
Posts
List posts with comments
/inbox/postsPosts of every connected account with their comment counters, most recent comment first.
Try it with MCPAsk your agent to call list-inbox-posts (toolset inbox)Set up MCP
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringlast_comment_atpublished_atcomment_count
orderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
profile_idstringOnly items of this profile (pro_…)
account_idstringOnly items of this account (sa_…)
platformstringfacebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmetametaads
min_commentsintegersincestring (date-time)unreadbooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 22 item attributes
objectstringinbox_post
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringpost_idstring | nullcontentstring | nullpicture_urlstring | nullpermalinkstring | nullpublished_atstring (date-time) | nullcomment_countintegerunread_comment_countintegerlike_countintegerlast_comment_atstring (date-time) | nullcidstring | nullsubredditstring | nullis_adbooleanad_idstring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Get a commented post
/inbox/posts/{postId}Try it with MCPAsk your agent to call get-inbox-post (toolset inbox)Set up MCP
Path parameters
postIdstringrequiredInbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)
1–500 characters
Query parameters
account_idstringReturns object
objectstringinbox_post
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringpost_idstring | nullcontentstring | nullpicture_urlstring | nullpermalinkstring | nullpublished_atstring (date-time) | nullcomment_countintegerunread_comment_countintegerlike_countintegerlast_comment_atstring (date-time) | nullcidstring | nullsubredditstring | nullis_adbooleanad_idstring | nullcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
List a post's comments
/inbox/posts/{postId}/commentsComments of one post, fetched from the network (default) and stored. comment_id lists that comment's replies.
Try it with MCPAsk your agent to call list-post-comments (toolset inbox)Set up MCP
Path parameters
postIdstringrequiredInbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)
1–500 characters
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringcommented_at
orderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
account_idstringcomment_idstringOnly replies of this comment (cmt_… or network id)
subredditstringrefreshbooleandefault: trueFetch from the network first (default true)
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 39 item attributes
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Comment on a post or reply to a comment
/inbox/posts/{postId}/commentsTry it with MCPAsk your agent to call create-comment (toolset inbox)Set up MCP
Path parameters
postIdstringrequiredInbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringtextstringrequired1–10000 characters
comment_idstringReply to this comment (cmt_… or network id)
attachment_urlstring (uri)media_idsarray of string≤ 10 items
parent_cidstringroot_uristringroot_cidstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Like a post
/inbox/posts/{postId}/likeLike (or react to) a post as any connected account, including posts of other accounts (LinkedIn, X, Facebook, YouTube, Bluesky, Instagram).
Try it with MCPAsk your agent to call like-post (toolset inbox)Set up MCP
Path parameters
postIdstringrequiredInbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringrequiredAccount id (sa_…)
1–80 characters
reaction_typestringLIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT
cidstringReturns object
objectstringpost_like
post_idstring | nullexternal_post_idstringaccount_idstringlikedbooleanlike_uristring | nullalready_reactedbooleanreaction_typestring | nullResponses
Unlike a post
/inbox/posts/{postId}/likeTry it with MCPAsk your agent to call unlike-post (toolset inbox)Set up MCP
Path parameters
postIdstringrequiredInbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)
1–500 characters
Query parameters
account_idstringrequiredAccount id (sa_…)
1–80 characters
like_uristringReturns object
objectstringpost_like
post_idstring | nullexternal_post_idstringaccount_idstringlikedbooleanlike_uristring | nullalready_reactedbooleanreaction_typestring | nullResponses
Comments
List comments
/inbox/commentsComment feed across every post (triage view): filter by read state, status, hidden, assignee, label, author.
Try it with MCPAsk your agent to call list-comments (toolset inbox)Set up MCP
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringcommented_atlike_count
orderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
profile_idstringOnly items of this profile (pro_…)
account_idstringOnly items of this account (sa_…)
platformstringfacebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta
inbox_post_idstringstatusstringopenarchived
readbooleanhiddenbooleanassignee_idstringlabelstringis_ownerbooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 39 item attributes
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Get a comment
/inbox/comments/{commentId}Try it with MCPAsk your agent to call get-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Query parameters
account_idstringlike_uristringpost_idstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Edit or triage a comment
/inbox/comments/{commentId}text edits the comment on the network (Reddit, and own comments on Facebook / YouTube / LinkedIn); read, status, assignee_id, labels are Socialit triage fields.
Try it with MCPAsk your agent to call update-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Body object
textstring1–10000 characters
contentstring1–10000 characters
readbooleanstatusstringopenarchived
assignee_idstring | nulllabelsarray of string≤ 20 items
account_idstringplatformstringIgnored (Zernio compatibility)
Returns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Delete a comment
/inbox/comments/{commentId}Try it with MCPAsk your agent to call delete-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Query parameters
account_idstringlike_uristringpost_idstringReturns object
objectstringrequiredcomment
idstringrequireddeletedbooleanrequiredResponses
Reply to a comment
/inbox/comments/{commentId}/repliesTry it with MCPAsk your agent to call reply-to-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired1–10000 characters
attachment_urlstring (uri)media_idsarray of string≤ 10 items
account_idstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Set comment moderation status
/inbox/comments/{commentId}/moderationYouTube: publish, reject or hold a comment for review, optionally banning the author.
Try it with MCPAsk your agent to call set-comment-moderation (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
moderation_statusstringrequiredpublishedrejectedheld_for_reviewheldForReview
ban_authorbooleanaccount_idstringplatformstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Hide a comment
/inbox/comments/{commentId}/hideTry it with MCPAsk your agent to call hide-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringpost_idstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Unhide a comment
/inbox/comments/{commentId}/hideTry it with MCPAsk your agent to call unhide-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Query parameters
account_idstringlike_uristringpost_idstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Pin a comment
/inbox/comments/{commentId}/pinTry it with MCPAsk your agent to call pin-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringpost_idstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Unpin a comment
/inbox/comments/{commentId}/pinTry it with MCPAsk your agent to call unpin-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Query parameters
account_idstringlike_uristringpost_idstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Like a comment
/inbox/comments/{commentId}/likeTry it with MCPAsk your agent to call like-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringreaction_typestringLIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT
cidstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Unlike a comment
/inbox/comments/{commentId}/likeTry it with MCPAsk your agent to call unlike-comment (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Query parameters
account_idstringlike_uristringpost_idstringReturns object
objectstringcomment
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullinbox_post_idstring | nullpost_idstring | nullexternal_post_idstringexternal_idstringparent_idstring | nullexternal_parent_idstring | nullis_replybooleanauthorobjectShow 6 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullis_ownerbooleantextstring | nullattachmentsarray of objectShow 2 item attributes
typestringurlstring | nulllike_countintegerreply_countintegeris_hiddenbooleanis_pinnedbooleanis_likedbooleanlike_uristring | nullcidstring | nullmoderation_statusstring | nullis_editedbooleanis_deletedbooleandeleted_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringcan_replybooleancan_deletebooleancan_hidebooleancan_likebooleanurlstring | nullcommented_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Send a private reply
/inbox/comments/{commentId}/private-replyDirect-message the author of a comment (Facebook, Instagram; one reply per comment within 7 days).
Try it with MCPAsk your agent to call send-private-reply (toolset inbox)Set up MCP
Path parameters
commentIdstringrequiredComment id (cmt_…) or the network comment id (with account_id)
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired1–2000 characters
quick_repliesarray of object≤ 13 items
Show 3 item attributes
titlestringrequired1–20 characters
payloadstringrequired≤ 1000 characters
image_urlstringbuttonsarray of object≤ 3 items
Show 5 item attributes
typestringrequiredurlpostbackphone
titlestringrequired1–20 characters
urlstringpayloadstringphonestringaccount_idstringReturns object
objectstringmessage
idstringconversation_idstringaccount_idstring | nullplatformstring | nullexternal_idstring | nulldirectionstringinboundoutbound
textstring | nullsenderobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullattachmentsarray of objectShow 9 item attributes
indexintegertypestringurlstring | nullmime_typestring | nullfilenamestring | nullsizeinteger | nullpreview_urlstring | nullmedia_idstring | nullrefresh_urlstring | nullstatusstringerrorobject | nullShow 2 child attributes
codestring | nullmessagestring | nullreactionsarray of objectShow 4 item attributes
emojistringfrom_mebooleansender_idstring | nullreacted_atstring (date-time) | nullreply_to_idstring | nullreply_to_external_idstring | nullis_editedbooleanedited_atstring (date-time) | nulledit_countintegeredit_historyarray of objectShow 2 item attributes
textstring | nulledited_atstring (date-time) | nullis_deletedbooleandeleted_atstring (date-time) | nullsent_viastring | nullsent_by_user_idstring | nullsent_atstring (date-time) | nulldelivered_atstring (date-time) | nullread_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Reviews
List reviews
/inbox/reviewsFacebook recommendations and Google Business reviews, newest first, with a rating summary.
Try it with MCPAsk your agent to call list-reviews (toolset inbox)Set up MCP
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringreviewed_atrating
orderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
profile_idstringOnly items of this profile (pro_…)
account_idstringOnly items of this account (sa_…)
platformstringfacebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta
min_ratinginteger1–5
max_ratinginteger1–5
has_replybooleanstatusstringopenarchived
readbooleanrefreshbooleandefault: falseFetch the latest reviews from the networks first
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 25 item attributes
objectstringreview
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringlocation_idstring | nulllocation_namestring | nullreviewerobjectShow 3 child attributes
idstring | nullnamestring | nullavatar_urlstring | nullratinginteger | nullrecommendationstring | nulltextstring | nullphotosarray of objectShow 1 item attributes
urlstring | nullhas_replybooleanreplyobject | nullShow 3 child attributes
external_idstring | nulltextstring | nullreplied_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringurlstring | nullreviewed_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullsummaryobjectShow 2 child attributes
total_reviewsintegeraverage_ratingnumber | nullResponses
Get a review
/inbox/reviews/{reviewId}Try it with MCPAsk your agent to call get-review (toolset inbox)Set up MCP
Path parameters
reviewIdstringrequiredReview id (rev_…) or the network review id (with account_id)
1–500 characters
Query parameters
account_idstringReturns object
objectstringreview
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringlocation_idstring | nulllocation_namestring | nullreviewerobjectShow 3 child attributes
idstring | nullnamestring | nullavatar_urlstring | nullratinginteger | nullrecommendationstring | nulltextstring | nullphotosarray of objectShow 1 item attributes
urlstring | nullhas_replybooleanreplyobject | nullShow 3 child attributes
external_idstring | nulltextstring | nullreplied_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringurlstring | nullreviewed_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Triage a review
/inbox/reviews/{reviewId}Try it with MCPAsk your agent to call update-review (toolset inbox)Set up MCP
Path parameters
reviewIdstringrequiredReview id (rev_…) or the network review id (with account_id)
1–500 characters
Body object
readbooleanstatusstringopenarchived
assignee_idstring | nulllabelsarray of string≤ 20 items
Returns object
objectstringreview
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringlocation_idstring | nulllocation_namestring | nullreviewerobjectShow 3 child attributes
idstring | nullnamestring | nullavatar_urlstring | nullratinginteger | nullrecommendationstring | nulltextstring | nullphotosarray of objectShow 1 item attributes
urlstring | nullhas_replybooleanreplyobject | nullShow 3 child attributes
external_idstring | nulltextstring | nullreplied_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringurlstring | nullreviewed_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Reply to a review
/inbox/reviews/{reviewId}/replyPost (or replace) the public reply to a review.
Try it with MCPAsk your agent to call reply-to-review (toolset inbox)Set up MCP
Path parameters
reviewIdstringrequiredReview id (rev_…) or the network review id (with account_id)
1–500 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired1–4096 characters
account_idstringReturns object
objectstringreview
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringlocation_idstring | nulllocation_namestring | nullreviewerobjectShow 3 child attributes
idstring | nullnamestring | nullavatar_urlstring | nullratinginteger | nullrecommendationstring | nulltextstring | nullphotosarray of objectShow 1 item attributes
urlstring | nullhas_replybooleanreplyobject | nullShow 3 child attributes
external_idstring | nulltextstring | nullreplied_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringurlstring | nullreviewed_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Delete a review reply
/inbox/reviews/{reviewId}/replyTry it with MCPAsk your agent to call delete-review-reply (toolset inbox)Set up MCP
Path parameters
reviewIdstringrequiredReview id (rev_…) or the network review id (with account_id)
1–500 characters
Query parameters
account_idstringReturns object
objectstringreview
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringlocation_idstring | nulllocation_namestring | nullreviewerobjectShow 3 child attributes
idstring | nullnamestring | nullavatar_urlstring | nullratinginteger | nullrecommendationstring | nulltextstring | nullphotosarray of objectShow 1 item attributes
urlstring | nullhas_replybooleanreplyobject | nullShow 3 child attributes
external_idstring | nulltextstring | nullreplied_atstring (date-time) | nullstatusstringopenarchived
readbooleanassignee_idstring | nulllabelsarray of stringurlstring | nullreviewed_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Mentions
List mentions
/inbox/mentionsTry it with MCPAsk your agent to call list-mentions (toolset inbox)Set up MCP
Query parameters
pageintegerdefault: 1Page number
≥ 1
limitintegerdefault: 20Items per page (max 100)
1–100
sortstringmentioned_at
orderstringascdesc
matchstringCombine filters with AND (default) or OR
allor
profile_idstringOnly items of this profile (pro_…)
account_idstringOnly items of this account (sa_…)
platformstringfacebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta
kindstringpostcommentcaptionstoryreplyquotetag
readbooleanstatusstringopenarchived
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 20 item attributes
objectstringmention
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringkindstringtextstring | nullpermalinkstring | nullauthorobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullmedia_idstring | nullcomment_idstring | nullrepliedbooleanstatusstringopenarchived
readbooleanmentioned_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullpageintegerrequiredlimitintegerrequiredtotalinteger | nullhas_morebooleanrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Get a mention
/inbox/mentions/{mentionId}Try it with MCPAsk your agent to call get-mention (toolset inbox)Set up MCP
Path parameters
mentionIdstringrequiredMention id (mtn_…)
1–80 characters
Returns object
objectstringmention
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringkindstringtextstring | nullpermalinkstring | nullauthorobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullmedia_idstring | nullcomment_idstring | nullrepliedbooleanstatusstringopenarchived
readbooleanmentioned_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Triage a mention
/inbox/mentions/{mentionId}Try it with MCPAsk your agent to call update-mention (toolset inbox)Set up MCP
Path parameters
mentionIdstringrequiredMention id (mtn_…)
1–80 characters
Body object
readbooleanstatusstringopenarchived
Returns object
objectstringmention
idstringaccount_idstring | nullprofile_idstring | nullplatformstring | nullaccountobject | nullShow 6 child attributes
idstringplatformstringusernamestring | nulldisplay_namestring | nullavatar_urlstring | nullprofile_idstring | nullexternal_idstringkindstringtextstring | nullpermalinkstring | nullauthorobject | nullShow 5 child attributes
idstring | nullnamestring | nullusernamestring | nullavatar_urlstring | nullverified_typestring | nullmedia_idstring | nullcomment_idstring | nullrepliedbooleanstatusstringopenarchived
readbooleanmentioned_atstring (date-time) | nullmetadataobjectcreated_atstring (date-time) | nullupdated_atstring (date-time) | nullResponses
Reply to a mention
/inbox/mentions/replyReply to a stored mention (mention_id) or to an Instagram media / comment mention (account_id + media_id [+ comment_id]).
Try it with MCPAsk your agent to call reply-to-mention (toolset inbox)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
textstringrequired1–2200 characters
mention_idstringaccount_idstringmedia_idstringcomment_idstringReturns object
objectstringmention_reply
idstring | nullmention_idstring | nullaccount_idstringmedia_idstring | nullcomment_idstring | nullResponses
Counts
Inbox counters
/inbox/countsUnread / open counters for badges.
Try it with MCPAsk your agent to call get-inbox-counts (toolset inbox)Set up MCP
Query parameters
profile_idstringaccount_idstringReturns object
objectstringinbox_counts
conversationsobjectShow 4 child attributes
openintegerunreadintegerunassignedintegerrequestsintegercommentsobjectShow 1 child attributes
unreadintegerreviewsobjectShow 2 child attributes
unreadintegerunansweredintegermentionsobjectShow 1 child attributes
unreadintegerResponses
Sync
Sync the inbox now
/inbox/syncQueue an immediate pull from the networks that are polled (Reddit, YouTube, Bluesky, Mastodon, X, Threads, LinkedIn, Google Business, Facebook reviews, TikTok mentions).
Try it with MCPAsk your agent to call sync-inbox (toolset inbox)Set up MCP
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
account_idstringkindsarray of stringunique
Returns object
objectstringinbox_sync
queuedintegeraccountsarray of stringkindsarray of stringResponses
Messenger menu
Get persistent menu
/accounts/{accountId}/messenger-menuRead the persistent menu of a Facebook or Instagram account.
Try it with MCPAsk your agent to call get-messenger-menu (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringmessenger_menu
account_idstringpersistent_menuarray of objectResponses
Set persistent menu
/accounts/{accountId}/messenger-menuReplace the persistent menu of a Facebook or Instagram account.
Try it with MCPAsk your agent to call set-messenger-menu (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Body object
persistent_menuarray of objectrequired≥ 1 items
Show 3 item attributes
localestringdefault: "default"composer_input_disabledbooleancall_to_actionsarray of objectrequired1–20 items
Show 6 item attributes
typestringpostbackweb_urlnested
titlestring1–30 characters
payloadstring≤ 1000 characters
urlstring≤ 2000 characters
webview_height_ratiostringcall_to_actionsarray of object≤ 5 items
Returns object
objectstringmessenger_menu
account_idstringpersistent_menuarray of objectResponses
Delete persistent menu
/accounts/{accountId}/messenger-menuRemove the persistent menu from a Facebook or Instagram account.
Try it with MCPAsk your agent to call delete-messenger-menu (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringmessenger_menu
idstringdeletedbooleanResponses
Messenger get started
Get Messenger Get Started button
/accounts/{accountId}/messenger-get-startedRead the Messenger Get Started button of a Facebook account.
Try it with MCPAsk your agent to call get-messenger-get-started (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringmessenger_get_started
account_idstringpayloadstring | nullResponses
Set Messenger Get Started button
/accounts/{accountId}/messenger-get-startedReplace the Messenger Get Started button of a Facebook account.
Try it with MCPAsk your agent to call set-messenger-get-started (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Body object
payloadstringrequired1–1000 characters
Returns object
objectstringmessenger_get_started
account_idstringpayloadstring | nullResponses
Delete Messenger Get Started button
/accounts/{accountId}/messenger-get-startedRemove the Messenger Get Started button from a Facebook account.
Try it with MCPAsk your agent to call delete-messenger-get-started (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringmessenger_get_started
idstringdeletedbooleanResponses
Messenger greeting
Get Messenger greeting text
/accounts/{accountId}/messenger-greetingRead the Messenger greeting text of a Facebook account.
Try it with MCPAsk your agent to call get-messenger-greeting (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringmessenger_greeting
account_idstringgreetingarray of objectShow 2 item attributes
localestringtextstringResponses
Set Messenger greeting text
/accounts/{accountId}/messenger-greetingReplace the Messenger greeting text of a Facebook account.
Try it with MCPAsk your agent to call set-messenger-greeting (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Body object
greetingarray of objectrequired≥ 1 items
Show 2 item attributes
localestringrequired≥ 1 characters
textstringrequired1–160 characters
Returns object
objectstringmessenger_greeting
account_idstringgreetingarray of objectShow 2 item attributes
localestringtextstringResponses
Delete Messenger greeting text
/accounts/{accountId}/messenger-greetingRemove the Messenger greeting text from a Facebook account.
Try it with MCPAsk your agent to call delete-messenger-greeting (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringmessenger_greeting
idstringdeletedbooleanResponses
Messenger ice breakers
Get Messenger ice breakers
/accounts/{accountId}/messenger-ice-breakersRead the Messenger ice breakers of a Facebook account.
Try it with MCPAsk your agent to call get-messenger-ice-breakers (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringmessenger_ice_breakers
account_idstringice_breakersarray of objectShow 2 item attributes
localestringcall_to_actionsarray of objectShow 2 item attributes
questionstringpayloadstringResponses
Set Messenger ice breakers
/accounts/{accountId}/messenger-ice-breakersReplace the Messenger ice breakers of a Facebook account.
Try it with MCPAsk your agent to call set-messenger-ice-breakers (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Body object
ice_breakersarray of objectrequired≥ 1 items
Show 2 item attributes
localestringrequired≥ 1 characters
call_to_actionsarray of objectrequired1–4 items
Show 2 item attributes
questionstringrequired1–80 characters
payloadstringrequired1–1000 characters
Returns object
objectstringmessenger_ice_breakers
account_idstringice_breakersarray of objectShow 2 item attributes
localestringcall_to_actionsarray of objectShow 2 item attributes
questionstringpayloadstringResponses
Delete Messenger ice breakers
/accounts/{accountId}/messenger-ice-breakersRemove the Messenger ice breakers from a Facebook account.
Try it with MCPAsk your agent to call delete-messenger-ice-breakers (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringmessenger_ice_breakers
idstringdeletedbooleanResponses
Instagram ice breakers
Get Instagram ice breakers
/accounts/{accountId}/instagram-ice-breakersRead the Instagram ice breakers of a Instagram account.
Try it with MCPAsk your agent to call get-instagram-ice-breakers (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringinstagram_ice_breakers
account_idstringice_breakersarray of objectShow 2 item attributes
questionstringpayloadstringResponses
Set Instagram ice breakers
/accounts/{accountId}/instagram-ice-breakersReplace the Instagram ice breakers of a Instagram account.
Try it with MCPAsk your agent to call set-instagram-ice-breakers (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Body object
ice_breakersarray of objectrequired1–4 items
Show 2 item attributes
questionstringrequired1–80 characters
payloadstringrequired1–1000 characters
Returns object
objectstringinstagram_ice_breakers
account_idstringice_breakersarray of objectShow 2 item attributes
questionstringpayloadstringResponses
Delete Instagram ice breakers
/accounts/{accountId}/instagram-ice-breakersRemove the Instagram ice breakers from a Instagram account.
Try it with MCPAsk your agent to call delete-instagram-ice-breakers (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Returns object
objectstringinstagram_ice_breakers
idstringdeletedbooleanResponses
X
Repost (retweet) a post on X
/accounts/{accountId}/x/retweetsTry it with MCPAsk your agent to call retweet (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
tweet_idstringrequired1–300 characters
Returns object
objectstringx_retweet
account_idstringtweet_idstringretweetedbooleanResponses
Undo a repost on X
/accounts/{accountId}/x/retweets/{tweetId}Try it with MCPAsk your agent to call unretweet (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
tweetIdstringrequired1–300 characters
Returns object
objectstringx_retweet
account_idstringtweet_idstringretweetedbooleanResponses
Bookmark a post on X
/accounts/{accountId}/x/bookmarksTry it with MCPAsk your agent to call bookmark-tweet (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
tweet_idstringrequired1–300 characters
Returns object
objectstringx_bookmark
account_idstringtweet_idstringbookmarkedbooleanResponses
Remove an X bookmark
/accounts/{accountId}/x/bookmarks/{tweetId}Try it with MCPAsk your agent to call remove-bookmark (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
tweetIdstringrequired1–300 characters
Returns object
objectstringx_bookmark
account_idstringtweet_idstringbookmarkedbooleanResponses
Follow a user on X
/accounts/{accountId}/x/followingFollow (or request to follow a protected account). Requires X Enterprise access: otherwise 402 enterprise_required.
Try it with MCPAsk your agent to call follow-x-user (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
target_user_idstringrequired1–64 characters
Returns object
objectstringx_follow
account_idstringtarget_user_idstringfollowingbooleanpending_followbooleanResponses
Unfollow a user on X
/accounts/{accountId}/x/following/{targetUserId}Try it with MCPAsk your agent to call unfollow-x-user (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
targetUserIdstringrequired1–64 characters
Returns object
objectstringx_follow
account_idstringtarget_user_idstringfollowingbooleanpending_followbooleanResponses
Search recent posts on X
/accounts/{accountId}/x/searchPosts from the last 7 days matching an X search query (operators passed through).
Try it with MCPAsk your agent to call search-tweets (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Query parameters
querystringrequired1–512 characters
limitintegerdefault: 1010–100
since_idstringpattern ^[0-9]+$
until_idstringpattern ^[0-9]+$
start_timestring (date-time)end_timestring (date-time)cursorstringsort_orderstringrecencyrelevancy
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
objectstringtweet
idstringtextstring | nullcreated_atstring (date-time) | nullconversation_idstring | nullin_reply_to_tweet_idstring | nulllangstring | nullauthorobjectShow 5 child attributes
idstring | nullusernamestring | nullnamestring | nullavatar_urlstring | nullverified_typestring | nulllike_countintegerreply_countintegerretweet_countintegerquote_countintegerurlstring | nulllimitintegerhas_morebooleanrequirednext_cursorstring | nullprevious_cursorstring | nullmetaobjectShow 3 child attributes
result_countintegernewest_idstring | nulloldest_idstring | nullResponses
Look up a post on X
/accounts/{accountId}/x/tweets/{tweetId}tweetId is the numeric id or a URL-encoded post URL.
Try it with MCPAsk your agent to call get-tweet (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
tweetIdstringrequired1–300 characters
Returns object
objectstringtweet
idstringtextstring | nullcreated_atstring (date-time) | nullconversation_idstring | nullin_reply_to_tweet_idstring | nulllangstring | nullauthorobjectShow 5 child attributes
idstring | nullusernamestring | nullnamestring | nullavatar_urlstring | nullverified_typestring | nulllike_countintegerreply_countintegerretweet_countintegerquote_countintegerurlstring | nullResponses
Search Reddit posts
/accounts/{accountId}/reddit/searchTry it with MCPAsk your agent to call search-reddit (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Query parameters
qstringrequired1–512 characters
subredditstring≤ 100 characters
restrict_srbooleansortstringrelevancehottopnewcomments
tstringhourdayweekmonthyearall
limitintegerdefault: 251–100
afterstringcursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 17 item attributes
objectstringreddit_post
idstringfullnamestring | nulltitlestring | nullauthorstring | nullsubredditstring | nullurlstring | nullpermalinkstring | nullselftextstring | nullcreated_atstring (date-time) | nullscoreintegernum_commentsintegerover_18booleanstickiedbooleanflair_textstring | nullis_gallerybooleangallery_imagesarray of stringlimitintegerhas_morebooleanrequirednext_cursorstring | nullprevious_cursorstring | nullResponses
Get a subreddit feed
/accounts/{accountId}/reddit/feedTry it with MCPAsk your agent to call get-reddit-feed (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
Query parameters
subredditstring≤ 100 characters
sortstringhotnewtoprising
tstringhourdayweekmonthyearall
limitintegerdefault: 251–100
afterstringcursorstringReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 17 item attributes
objectstringreddit_post
idstringfullnamestring | nulltitlestring | nullauthorstring | nullsubredditstring | nullurlstring | nullpermalinkstring | nullselftextstring | nullcreated_atstring (date-time) | nullscoreintegernum_commentsintegerover_18booleanstickiedbooleanflair_textstring | nullis_gallerybooleangallery_imagesarray of stringlimitintegerhas_morebooleanrequirednext_cursorstring | nullprevious_cursorstring | nullResponses
Get a Reddit post's comments
/accounts/{accountId}/reddit/posts/{postId}/commentsTry it with MCPAsk your agent to call get-reddit-post-comments (toolset inbox)Set up MCP
Path parameters
accountIdstringrequiredAccount id (sa_…)
1–80 characters
postIdstringrequired1–64 characters
Query parameters
sortstringnewtopbestcontroversialoldqa
limitintegerdefault: 251–500
comment_idstring≤ 64 characters
Returns object
objectstringreddit_comment_thread
postobject | nulldataarray of objectShow 15 item attributes
objectstringreddit_comment
idstringfullnamestring | nullparent_idstring | nullauthorstring | nullbodystring | nullpermalinkstring | nullcreated_atstring (date-time) | nullscoreintegernum_repliesintegerdepthintegeris_submitterbooleaneditedbooleanstickiedbooleandistinguishedstring | nullmorearray of string