Skip to content
Docs

Unified inbox: direct messages, comments, reviews and mentions across networks, plus messaging settings, X engagement and Reddit discovery.

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits72 endpointsMCP toolset inbox

Conversations

List conversations

GET/inbox/conversations

Direct-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.

Access: readZernio: GET /v1/inbox/conversations

Try it with MCPAsk your agent to call list-conversations (toolset inbox)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

last_message_atcreated_atunread_count

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

profile_idstring

Only items of this profile (pro_…)

account_idstring

Only items of this account (sa_…)

platformstring

facebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta

statusstring

openactivearchivedsnoozed

folderstring

inboxrequests

assignee_idstring

usr_… or "none" for unassigned

labelstring
unreadboolean
qstring

Participant name / username contains

≤ 200 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 25 item attributes
objectstring

conversation

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
participantobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_groupboolean
folderstring

inboxrequests

statusstring

openarchivedsnoozed

snoozed_untilstring (date-time) | null
unread_countinteger
assignee_idstring | null
labelsarray of string
thread_ownerstring | null
contact_idstring | null
last_message_previewstring | null
last_message_directionstring | null

inboundoutbound

last_message_atstring (date-time) | null
last_inbound_atstring (date-time) | null
urlstring | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/conversations
curl "https://api.socialit.com/v1/inbox/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Start a conversation

POST/inbox/conversations

Open 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.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations

Try it with MCPAsk your agent to call create-conversation (toolset inbox)Set up MCP

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Account id (sa_…)

1–80 characters

participant_idstring

1–300 characters

participant_usernamestring

1–300 characters

textstring

1–20000 characters

media_idsarray of string

≤ 10 items

attachment_urlstring (uri)
attachment_typestring

imagevideoaudiofile

skip_dm_checkboolean
templateobject
Show 7 child attributes
namestringrequired

≥ 1 characters

languagestring
paramsarray of string
button_paramsarray of object
cardsarray of object
header_mediaobject
header_locationobject
categorystring

utilitymarketingauthentication

link_previewboolean

Returns object

objectstring

conversation

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
participantobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_groupboolean
folderstring

inboxrequests

statusstring

openarchivedsnoozed

snoozed_untilstring (date-time) | null
unread_countinteger
assignee_idstring | null
labelsarray of string
thread_ownerstring | null
contact_idstring | null
last_message_previewstring | null
last_message_directionstring | null

inboundoutbound

last_message_atstring (date-time) | null
last_inbound_atstring (date-time) | null
urlstring | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null
sent_messageobject | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/conversations
curl -X POST "https://api.socialit.com/v1/inbox/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "participant_id": "string",
    "participant_username": "string",
    "text": "string",
    "media_ids": [
      "med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ]
  }'
Response · 201

Search conversations

GET/inbox/conversations/search

Search message text and participant identity (name, username, id). Each result carries up to 3 matching messages, most recent match first.

Access: readZernio: GET /v1/inbox/conversations/search

Try it with MCPAsk your agent to call search-conversations (toolset inbox)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring
orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

profile_idstring

Only items of this profile (pro_…)

account_idstring

Only items of this account (sa_…)

platformstring

facebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta

qstring

Text to search in messages and participant identity

1–200 characters

querystring

Alias of q (Zernio)

1–200 characters

directionstring

inboundoutboundincomingoutgoing

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
objectstring

conversation_search_result

conversationobject
Show 25 child attributes
objectstring

conversation

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
participantobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_groupboolean
folderstring

inboxrequests

statusstring

openarchivedsnoozed

snoozed_untilstring (date-time) | null
unread_countinteger
assignee_idstring | null
labelsarray of string
thread_ownerstring | null
contact_idstring | null
last_message_previewstring | null
last_message_directionstring | null

inboundoutbound

last_message_atstring (date-time) | null
last_inbound_atstring (date-time) | null
urlstring | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null
match_countinteger
matchesarray of object
Show 4 item attributes
idstring
textstring | null
directionstring

inboundoutbound

sent_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/conversations/search
curl "https://api.socialit.com/v1/inbox/conversations/search" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get a conversation

GET/inbox/conversations/{conversationId}

Access: readZernio: GET /v1/inbox/conversations/{conversationId}

Try it with MCPAsk your agent to call get-conversation (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…)

1–80 characters

Returns object

objectstring

conversation

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
participantobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_groupboolean
folderstring

inboxrequests

statusstring

openarchivedsnoozed

snoozed_untilstring (date-time) | null
unread_countinteger
assignee_idstring | null
labelsarray of string
thread_ownerstring | null
contact_idstring | null
last_message_previewstring | null
last_message_directionstring | null

inboundoutbound

last_message_atstring (date-time) | null
last_inbound_atstring (date-time) | null
urlstring | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/conversations/{conversationId}
curl "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Update a conversation

PATCH/inbox/conversations/{conversationId}

Archive, reopen or snooze a conversation, assign it to a workspace member, set labels or link a contact.

Access: writeZernio: PUT /v1/inbox/conversations/{conversationId}

Try it with MCPAsk your agent to call update-conversation (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…)

1–80 characters

Body object

statusstring

openactivearchivedsnoozed

snoozed_untilstring (date-time) | null
assignee_idstring | null
labelsarray of string

≤ 20 items

contact_idstring | null
account_idstring

Ignored (Zernio compatibility)

Returns object

objectstring

conversation

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
participantobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_groupboolean
folderstring

inboxrequests

statusstring

openarchivedsnoozed

snoozed_untilstring (date-time) | null
unread_countinteger
assignee_idstring | null
labelsarray of string
thread_ownerstring | null
contact_idstring | null
last_message_previewstring | null
last_message_directionstring | null

inboundoutbound

last_message_atstring (date-time) | null
last_inbound_atstring (date-time) | null
urlstring | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/inbox/conversations/{conversationId}
curl -X PATCH "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "open",
    "snoozed_until": "2026-10-13T09:00:00.000Z",
    "assignee_id": "string",
    "labels": [
      "string"
    ],
    "contact_id": "string"
  }'
Response · 200

Accept a message request

POST/inbox/conversations/{conversationId}/accept

Accept a Facebook / Instagram (or Bluesky) message request by replying to it; the thread moves to the inbox folder.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/accept

Try it with MCPAsk your agent to call accept-conversation (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

textstringrequired

1–20000 characters

account_idstring

Returns object

objectstring

message

idstring
conversation_idstring
account_idstring | null
platformstring | null
external_idstring | null
directionstring

inboundoutbound

textstring | null
senderobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
attachmentsarray of object
Show 9 item attributes
indexinteger
typestring
urlstring | null
mime_typestring | null
filenamestring | null
sizeinteger | null
preview_urlstring | null
media_idstring | null
refresh_urlstring | null
statusstring
errorobject | null
Show 2 child attributes
codestring | null
messagestring | null
reactionsarray of object
Show 4 item attributes
emojistring
from_meboolean
sender_idstring | null
reacted_atstring (date-time) | null
reply_to_idstring | null
reply_to_external_idstring | null
is_editedboolean
edited_atstring (date-time) | null
edit_countinteger
edit_historyarray of object
Show 2 item attributes
textstring | null
edited_atstring (date-time) | null
is_deletedboolean
deleted_atstring (date-time) | null
sent_viastring | null
sent_by_user_idstring | null
sent_atstring (date-time) | null
delivered_atstring (date-time) | null
read_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/conversations/{conversationId}/accept
curl -X POST "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/accept" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "account_id": "string"
  }'
Response · 200

Mark a conversation as read

POST/inbox/conversations/{conversationId}/read

Marks every unread inbound message as read and sends read receipts where the network supports them (Messenger, Instagram, Bluesky, TikTok, Reddit, Mastodon).

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/read

Try it with MCPAsk your agent to call mark-conversation-read (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstring

Returns object

objectstring

conversation

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
participantobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_groupboolean
folderstring

inboxrequests

statusstring

openarchivedsnoozed

snoozed_untilstring (date-time) | null
unread_countinteger
assignee_idstring | null
labelsarray of string
thread_ownerstring | null
contact_idstring | null
last_message_previewstring | null
last_message_directionstring | null

inboundoutbound

last_message_atstring (date-time) | null
last_inbound_atstring (date-time) | null
urlstring | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/conversations/{conversationId}/read
curl -X POST "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/read" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string"
  }'
Response · 200

Mark a conversation as unread

POST/inbox/conversations/{conversationId}/unread

Flags the conversation unread in Socialit (no network call).

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call mark-conversation-unread (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstring

conversation

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
participantobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_groupboolean
folderstring

inboxrequests

statusstring

openarchivedsnoozed

snoozed_untilstring (date-time) | null
unread_countinteger
assignee_idstring | null
labelsarray of string
thread_ownerstring | null
contact_idstring | null
last_message_previewstring | null
last_message_directionstring | null

inboundoutbound

last_message_atstring (date-time) | null
last_inbound_atstring (date-time) | null
urlstring | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/conversations/{conversationId}/unread
curl -X POST "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/unread" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
Response · 200

Send a typing indicator

POST/inbox/conversations/{conversationId}/typing

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/typing

Try it with MCPAsk your agent to call send-typing-indicator (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstring

Returns object

objectstring

typing_indicator

conversation_idstring
sentboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/conversations/{conversationId}/typing
curl -X POST "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/typing" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string"
  }'
Response · 200

Change who answers a conversation

POST/inbox/conversations/{conversationId}/thread-control

Meta's handover protocol: take, pass, release or request thread control.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/thread-control

Try it with MCPAsk your agent to call change-thread-control (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

actionstringrequired

releasetakepassrequest

targetstring

ai_agent

target_app_idstring

≤ 100 characters

metadatastring

≤ 1000 characters

account_idstring

Returns object

objectstring

thread_control

conversation_idstring
ownerstring | null
owner_app_idstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/conversations/{conversationId}/thread-control
curl -X POST "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/thread-control" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "release",
    "target": "ai_agent",
    "target_app_id": "string",
    "metadata": "string",
    "account_id": "string"
  }'
Response · 200

List messages

GET/inbox/conversations/{conversationId}/messages

Messages of a conversation, oldest first by default (order=desc for the latest). refresh=true pulls the newest messages from the network first.

Access: readZernio: GET /v1/inbox/conversations/{conversationId}/messages

Try it with MCPAsk your agent to call list-messages (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…)

1–80 characters

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

sent_at

orderstringdefault: "asc"

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

directionstring

inboundoutbound

refreshbooleandefault: false

Pull the latest messages from the network first

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 29 item attributes
objectstring

message

idstring
conversation_idstring
account_idstring | null
platformstring | null
external_idstring | null
directionstring

inboundoutbound

textstring | null
senderobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
attachmentsarray of object
Show 9 item attributes
indexinteger
typestring
urlstring | null
mime_typestring | null
filenamestring | null
sizeinteger | null
preview_urlstring | null
media_idstring | null
refresh_urlstring | null
statusstring
errorobject | null
Show 2 child attributes
codestring | null
messagestring | null
reactionsarray of object
Show 4 item attributes
emojistring
from_meboolean
sender_idstring | null
reacted_atstring (date-time) | null
reply_to_idstring | null
reply_to_external_idstring | null
is_editedboolean
edited_atstring (date-time) | null
edit_countinteger
edit_historyarray of object
Show 2 item attributes
textstring | null
edited_atstring (date-time) | null
is_deletedboolean
deleted_atstring (date-time) | null
sent_viastring | null
sent_by_user_idstring | null
sent_atstring (date-time) | null
delivered_atstring (date-time) | null
read_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/conversations/{conversationId}/messages
curl "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Send a message

POST/inbox/conversations/{conversationId}/messages

Send 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.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/messages

Try it with MCPAsk your agent to call send-message (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

Conversation id (conv_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

textstring

1–20000 characters

media_idsarray of string

≤ 10 items

attachment_urlstring (uri)
attachment_typestring

imagevideoaudiofile

attachment_namestring

≤ 255 characters

quick_repliesarray of object

≤ 13 items

Show 3 item attributes
titlestringrequired

1–20 characters

payloadstringrequired

≤ 1000 characters

image_urlstring
buttonsarray of object

≤ 3 items

Show 5 item attributes
typestringrequired

urlpostbackphone

titlestringrequired

1–20 characters

urlstring
payloadstring
phonestring
templateobject
messaging_typestring

RESPONSEUPDATEMESSAGE_TAG

message_tagstring

CONFIRMED_EVENT_UPDATEPOST_PURCHASE_UPDATEACCOUNT_UPDATEHUMAN_AGENT

reply_tostring

≤ 300 characters

subjectstring

≤ 300 characters

account_idstring

Ignored (Zernio compatibility)

Returns object

objectstring

message

idstring
conversation_idstring
account_idstring | null
platformstring | null
external_idstring | null
directionstring

inboundoutbound

textstring | null
senderobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
attachmentsarray of object
Show 9 item attributes
indexinteger
typestring
urlstring | null
mime_typestring | null
filenamestring | null
sizeinteger | null
preview_urlstring | null
media_idstring | null
refresh_urlstring | null
statusstring
errorobject | null
Show 2 child attributes
codestring | null
messagestring | null
reactionsarray of object
Show 4 item attributes
emojistring
from_meboolean
sender_idstring | null
reacted_atstring (date-time) | null
reply_to_idstring | null
reply_to_external_idstring | null
is_editedboolean
edited_atstring (date-time) | null
edit_countinteger
edit_historyarray of object
Show 2 item attributes
textstring | null
edited_atstring (date-time) | null
is_deletedboolean
deleted_atstring (date-time) | null
sent_viastring | null
sent_by_user_idstring | null
sent_atstring (date-time) | null
delivered_atstring (date-time) | null
read_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/conversations/{conversationId}/messages
curl -X POST "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "media_ids": [
      "med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ],
    "attachment_url": "https://example.com",
    "attachment_type": "image",
    "attachment_name": "string"
  }'
Response · 201

Delete a message

DELETE/inbox/conversations/{conversationId}/messages/{messageId}

Delete / unsend a message (X, Bluesky for self, Reddit).

Access: writeZernio: DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}

Try it with MCPAsk your agent to call delete-message (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

conversation id (conv_…)

1–80 characters

messageIdstringrequired

Message id (msg_…) or the network message id

1–500 characters

Returns object

objectstringrequired

message

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/inbox/conversations/{conversationId}/messages/{messageId}
curl -X DELETE "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages/MESSAGE_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

React to a message

POST/inbox/conversations/{conversationId}/messages/{messageId}/reactions

Access: writeIdempotency-KeyZernio: POST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions

Try it with MCPAsk your agent to call add-message-reaction (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

conversation id (conv_…)

1–80 characters

messageIdstringrequired

Message id (msg_…) or the network message id

1–500 characters

Headers

Idempotency-Keystring

Unique 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

emojistringrequired

1–64 characters

account_idstring

Returns object

objectstring

message

idstring
conversation_idstring
account_idstring | null
platformstring | null
external_idstring | null
directionstring

inboundoutbound

textstring | null
senderobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
attachmentsarray of object
Show 9 item attributes
indexinteger
typestring
urlstring | null
mime_typestring | null
filenamestring | null
sizeinteger | null
preview_urlstring | null
media_idstring | null
refresh_urlstring | null
statusstring
errorobject | null
Show 2 child attributes
codestring | null
messagestring | null
reactionsarray of object
Show 4 item attributes
emojistring
from_meboolean
sender_idstring | null
reacted_atstring (date-time) | null
reply_to_idstring | null
reply_to_external_idstring | null
is_editedboolean
edited_atstring (date-time) | null
edit_countinteger
edit_historyarray of object
Show 2 item attributes
textstring | null
edited_atstring (date-time) | null
is_deletedboolean
deleted_atstring (date-time) | null
sent_viastring | null
sent_by_user_idstring | null
sent_atstring (date-time) | null
delivered_atstring (date-time) | null
read_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/conversations/{conversationId}/messages/{messageId}/reactions
curl -X POST "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages/MESSAGE_ID/reactions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "emoji": "string",
    "account_id": "string"
  }'
Response · 200

Remove a reaction

DELETE/inbox/conversations/{conversationId}/messages/{messageId}/reactions

Access: writeZernio: DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions

Try it with MCPAsk your agent to call remove-message-reaction (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

conversation id (conv_…)

1–80 characters

messageIdstringrequired

Message id (msg_…) or the network message id

1–500 characters

Query parameters

emojistring

≤ 64 characters

account_idstring

Returns object

objectstring

message

idstring
conversation_idstring
account_idstring | null
platformstring | null
external_idstring | null
directionstring

inboundoutbound

textstring | null
senderobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
attachmentsarray of object
Show 9 item attributes
indexinteger
typestring
urlstring | null
mime_typestring | null
filenamestring | null
sizeinteger | null
preview_urlstring | null
media_idstring | null
refresh_urlstring | null
statusstring
errorobject | null
Show 2 child attributes
codestring | null
messagestring | null
reactionsarray of object
Show 4 item attributes
emojistring
from_meboolean
sender_idstring | null
reacted_atstring (date-time) | null
reply_to_idstring | null
reply_to_external_idstring | null
is_editedboolean
edited_atstring (date-time) | null
edit_countinteger
edit_historyarray of object
Show 2 item attributes
textstring | null
edited_atstring (date-time) | null
is_deletedboolean
deleted_atstring (date-time) | null
sent_viastring | null
sent_by_user_idstring | null
sent_atstring (date-time) | null
delivered_atstring (date-time) | null
read_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/inbox/conversations/{conversationId}/messages/{messageId}/reactions
curl -X DELETE "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages/MESSAGE_ID/reactions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Resolve a message attachment

GET/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.

Access: readZernio: GET /v1/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}

Try it with MCPAsk your agent to call get-message-attachment (toolset inbox)Set up MCP

Path parameters

conversationIdstringrequired

conversation id (conv_…)

1–80 characters

messageIdstringrequired

Message id

1–500 characters

indexintegerrequired

0–50

Query parameters

formatstringdefault: "redirect"

redirectjson

account_idstring

Returns object

objectstring

message_attachment

message_idstring
indexinteger
typestring
urlstring | null
mime_typestring | null
refreshedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}
curl "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages/MESSAGE_ID/attachments/INDEX" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Posts

List posts with comments

GET/inbox/posts

Posts of every connected account with their comment counters, most recent comment first.

Access: readZernio: GET /v1/inbox/comments

Try it with MCPAsk your agent to call list-inbox-posts (toolset inbox)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

last_comment_atpublished_atcomment_count

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

profile_idstring

Only items of this profile (pro_…)

account_idstring

Only items of this account (sa_…)

platformstring

facebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmetametaads

min_commentsinteger
sincestring (date-time)
unreadboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 22 item attributes
objectstring

inbox_post

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
post_idstring | null
contentstring | null
picture_urlstring | null
permalinkstring | null
published_atstring (date-time) | null
comment_countinteger
unread_comment_countinteger
like_countinteger
last_comment_atstring (date-time) | null
cidstring | null
subredditstring | null
is_adboolean
ad_idstring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/posts
curl "https://api.socialit.com/v1/inbox/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get a commented post

GET/inbox/posts/{postId}

Access: read

Try it with MCPAsk your agent to call get-inbox-post (toolset inbox)Set up MCP

Path parameters

postIdstringrequired

Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

1–500 characters

Query parameters

account_idstring

Returns object

objectstring

inbox_post

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
post_idstring | null
contentstring | null
picture_urlstring | null
permalinkstring | null
published_atstring (date-time) | null
comment_countinteger
unread_comment_countinteger
like_countinteger
last_comment_atstring (date-time) | null
cidstring | null
subredditstring | null
is_adboolean
ad_idstring | null
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/posts/{postId}
curl "https://api.socialit.com/v1/inbox/posts/POST_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

List a post's comments

GET/inbox/posts/{postId}/comments

Comments of one post, fetched from the network (default) and stored. comment_id lists that comment's replies.

Access: readZernio: GET /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call list-post-comments (toolset inbox)Set up MCP

Path parameters

postIdstringrequired

Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

1–500 characters

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

commented_at

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

account_idstring
comment_idstring

Only replies of this comment (cmt_… or network id)

subredditstring
refreshbooleandefault: true

Fetch from the network first (default true)

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 39 item attributes
objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/posts/{postId}/comments
curl "https://api.socialit.com/v1/inbox/posts/POST_ID/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Comment on a post or reply to a comment

POST/inbox/posts/{postId}/comments

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call create-comment (toolset inbox)Set up MCP

Path parameters

postIdstringrequired

Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

1–500 characters

Headers

Idempotency-Keystring

Unique 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_idstring
textstringrequired

1–10000 characters

comment_idstring

Reply to this comment (cmt_… or network id)

attachment_urlstring (uri)
media_idsarray of string

≤ 10 items

parent_cidstring
root_uristring
root_cidstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/posts/{postId}/comments
curl -X POST "https://api.socialit.com/v1/inbox/posts/POST_ID/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "text": "string",
    "comment_id": "string",
    "attachment_url": "https://example.com",
    "media_ids": [
      "med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ]
  }'
Response · 201

Like a post

POST/inbox/posts/{postId}/like

Like (or react to) a post as any connected account, including posts of other accounts (LinkedIn, X, Facebook, YouTube, Bluesky, Instagram).

Access: writeIdempotency-KeyZernio: POST /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call like-post (toolset inbox)Set up MCP

Path parameters

postIdstringrequired

Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

1–500 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

Account id (sa_…)

1–80 characters

reaction_typestring

LIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT

cidstring

Returns object

objectstring

post_like

post_idstring | null
external_post_idstring
account_idstring
likedboolean
like_uristring | null
already_reactedboolean
reaction_typestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/posts/{postId}/like
curl -X POST "https://api.socialit.com/v1/inbox/posts/POST_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "reaction_type": "LIKE",
    "cid": "string"
  }'
Response · 200

Unlike a post

DELETE/inbox/posts/{postId}/like

Access: writeZernio: DELETE /v1/inbox/posts/{postId}/like

Try it with MCPAsk your agent to call unlike-post (toolset inbox)Set up MCP

Path parameters

postIdstringrequired

Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

1–500 characters

Query parameters

account_idstringrequired

Account id (sa_…)

1–80 characters

like_uristring

Returns object

objectstring

post_like

post_idstring | null
external_post_idstring
account_idstring
likedboolean
like_uristring | null
already_reactedboolean
reaction_typestring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/inbox/posts/{postId}/like
curl -X DELETE "https://api.socialit.com/v1/inbox/posts/POST_ID/like?account_id=sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Comments

List comments

GET/inbox/comments

Comment feed across every post (triage view): filter by read state, status, hidden, assignee, label, author.

Access: read

Try it with MCPAsk your agent to call list-comments (toolset inbox)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

commented_atlike_count

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

profile_idstring

Only items of this profile (pro_…)

account_idstring

Only items of this account (sa_…)

platformstring

facebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta

inbox_post_idstring
statusstring

openarchived

readboolean
hiddenboolean
assignee_idstring
labelstring
is_ownerboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 39 item attributes
objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/comments
curl "https://api.socialit.com/v1/inbox/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get a comment

GET/inbox/comments/{commentId}

Access: read

Try it with MCPAsk your agent to call get-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Query parameters

account_idstring
like_uristring
post_idstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/comments/{commentId}
curl "https://api.socialit.com/v1/inbox/comments/COMMENT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Edit or triage a comment

PATCH/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.

Access: writeZernio: PATCH /v1/inbox/comments/{postId}/{commentId}

Try it with MCPAsk your agent to call update-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Body object

textstring

1–10000 characters

contentstring

1–10000 characters

readboolean
statusstring

openarchived

assignee_idstring | null
labelsarray of string

≤ 20 items

account_idstring
platformstring

Ignored (Zernio compatibility)

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/inbox/comments/{commentId}
curl -X PATCH "https://api.socialit.com/v1/inbox/comments/COMMENT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "content": "string",
    "read": true,
    "status": "open",
    "assignee_id": "string"
  }'
Response · 200

Delete a comment

DELETE/inbox/comments/{commentId}

Access: writeZernio: DELETE /v1/inbox/comments/{postId}

Try it with MCPAsk your agent to call delete-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Query parameters

account_idstring
like_uristring
post_idstring

Returns object

objectstringrequired

comment

idstringrequired
deletedbooleanrequired

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/inbox/comments/{commentId}
curl -X DELETE "https://api.socialit.com/v1/inbox/comments/COMMENT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reply to a comment

POST/inbox/comments/{commentId}/replies

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call reply-to-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Headers

Idempotency-Keystring

Unique 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

textstringrequired

1–10000 characters

attachment_urlstring (uri)
media_idsarray of string

≤ 10 items

account_idstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/comments/{commentId}/replies
curl -X POST "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/replies" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "attachment_url": "https://example.com",
    "media_ids": [
      "med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ],
    "account_id": "string"
  }'
Response · 201

Set comment moderation status

POST/inbox/comments/{commentId}/moderation

YouTube: publish, reject or hold a comment for review, optionally banning the author.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}/{commentId}/moderation

Try it with MCPAsk your agent to call set-comment-moderation (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Headers

Idempotency-Keystring

Unique 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_statusstringrequired

publishedrejectedheld_for_reviewheldForReview

ban_authorboolean
account_idstring
platformstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/comments/{commentId}/moderation
curl -X POST "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/moderation" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "moderation_status": "published",
    "ban_author": true,
    "account_id": "string",
    "platform": "string"
  }'
Response · 200

Hide a comment

POST/inbox/comments/{commentId}/hide

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}/{commentId}/hide

Try it with MCPAsk your agent to call hide-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Headers

Idempotency-Keystring

Unique 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_idstring
post_idstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/comments/{commentId}/hide
curl -X POST "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "post_id": "string"
  }'
Response · 200

Unhide a comment

DELETE/inbox/comments/{commentId}/hide

Access: writeZernio: DELETE /v1/inbox/comments/{postId}/{commentId}/hide

Try it with MCPAsk your agent to call unhide-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Query parameters

account_idstring
like_uristring
post_idstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/inbox/comments/{commentId}/hide
curl -X DELETE "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pin a comment

POST/inbox/comments/{commentId}/pin

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}/{commentId}/pin

Try it with MCPAsk your agent to call pin-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Headers

Idempotency-Keystring

Unique 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_idstring
post_idstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/comments/{commentId}/pin
curl -X POST "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "post_id": "string"
  }'
Response · 200

Unpin a comment

DELETE/inbox/comments/{commentId}/pin

Access: writeZernio: DELETE /v1/inbox/comments/{postId}/{commentId}/pin

Try it with MCPAsk your agent to call unpin-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Query parameters

account_idstring
like_uristring
post_idstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/inbox/comments/{commentId}/pin
curl -X DELETE "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Like a comment

POST/inbox/comments/{commentId}/like

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call like-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Headers

Idempotency-Keystring

Unique 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_idstring
reaction_typestring

LIKEPRAISEEMPATHYINTERESTAPPRECIATIONENTERTAINMENT

cidstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/comments/{commentId}/like
curl -X POST "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "reaction_type": "LIKE",
    "cid": "string"
  }'
Response · 200

Unlike a comment

DELETE/inbox/comments/{commentId}/like

Access: writeZernio: DELETE /v1/inbox/comments/{postId}/{commentId}/like

Try it with MCPAsk your agent to call unlike-comment (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Query parameters

account_idstring
like_uristring
post_idstring

Returns object

objectstring

comment

idstring
account_idstring | null
profile_idstring | null
platformstring | null
inbox_post_idstring | null
post_idstring | null
external_post_idstring
external_idstring
parent_idstring | null
external_parent_idstring | null
is_replyboolean
authorobject
Show 6 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
is_ownerboolean
textstring | null
attachmentsarray of object
Show 2 item attributes
typestring
urlstring | null
like_countinteger
reply_countinteger
is_hiddenboolean
is_pinnedboolean
is_likedboolean
like_uristring | null
cidstring | null
moderation_statusstring | null
is_editedboolean
is_deletedboolean
deleted_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
can_replyboolean
can_deleteboolean
can_hideboolean
can_likeboolean
urlstring | null
commented_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/inbox/comments/{commentId}/like
curl -X DELETE "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Send a private reply

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

Direct-message the author of a comment (Facebook, Instagram; one reply per comment within 7 days).

Access: writeIdempotency-KeyZernio: POST /v1/inbox/comments/{postId}/{commentId}/private-reply

Try it with MCPAsk your agent to call send-private-reply (toolset inbox)Set up MCP

Path parameters

commentIdstringrequired

Comment id (cmt_…) or the network comment id (with account_id)

1–500 characters

Headers

Idempotency-Keystring

Unique 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

textstringrequired

1–2000 characters

quick_repliesarray of object

≤ 13 items

Show 3 item attributes
titlestringrequired

1–20 characters

payloadstringrequired

≤ 1000 characters

image_urlstring
buttonsarray of object

≤ 3 items

Show 5 item attributes
typestringrequired

urlpostbackphone

titlestringrequired

1–20 characters

urlstring
payloadstring
phonestring
account_idstring

Returns object

objectstring

message

idstring
conversation_idstring
account_idstring | null
platformstring | null
external_idstring | null
directionstring

inboundoutbound

textstring | null
senderobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
attachmentsarray of object
Show 9 item attributes
indexinteger
typestring
urlstring | null
mime_typestring | null
filenamestring | null
sizeinteger | null
preview_urlstring | null
media_idstring | null
refresh_urlstring | null
statusstring
errorobject | null
Show 2 child attributes
codestring | null
messagestring | null
reactionsarray of object
Show 4 item attributes
emojistring
from_meboolean
sender_idstring | null
reacted_atstring (date-time) | null
reply_to_idstring | null
reply_to_external_idstring | null
is_editedboolean
edited_atstring (date-time) | null
edit_countinteger
edit_historyarray of object
Show 2 item attributes
textstring | null
edited_atstring (date-time) | null
is_deletedboolean
deleted_atstring (date-time) | null
sent_viastring | null
sent_by_user_idstring | null
sent_atstring (date-time) | null
delivered_atstring (date-time) | null
read_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/comments/{commentId}/private-reply
curl -X POST "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/private-reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "quick_replies": [
      {
        "title": "string",
        "payload": "string"
      }
    ],
    "buttons": [
      {
        "type": "url",
        "title": "string"
      }
    ],
    "account_id": "string"
  }'
Response · 201

Reviews

List reviews

GET/inbox/reviews

Facebook recommendations and Google Business reviews, newest first, with a rating summary.

Access: readZernio: GET /v1/inbox/reviews

Try it with MCPAsk your agent to call list-reviews (toolset inbox)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

reviewed_atrating

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

profile_idstring

Only items of this profile (pro_…)

account_idstring

Only items of this account (sa_…)

platformstring

facebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta

min_ratinginteger

1–5

max_ratinginteger

1–5

has_replyboolean
statusstring

openarchived

readboolean
refreshbooleandefault: false

Fetch the latest reviews from the networks first

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 25 item attributes
objectstring

review

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
location_idstring | null
location_namestring | null
reviewerobject
Show 3 child attributes
idstring | null
namestring | null
avatar_urlstring | null
ratinginteger | null
recommendationstring | null
textstring | null
photosarray of object
Show 1 item attributes
urlstring | null
has_replyboolean
replyobject | null
Show 3 child attributes
external_idstring | null
textstring | null
replied_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
urlstring | null
reviewed_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null
summaryobject
Show 2 child attributes
total_reviewsinteger
average_ratingnumber | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/reviews
curl "https://api.socialit.com/v1/inbox/reviews" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get a review

GET/inbox/reviews/{reviewId}

Access: read

Try it with MCPAsk your agent to call get-review (toolset inbox)Set up MCP

Path parameters

reviewIdstringrequired

Review id (rev_…) or the network review id (with account_id)

1–500 characters

Query parameters

account_idstring

Returns object

objectstring

review

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
location_idstring | null
location_namestring | null
reviewerobject
Show 3 child attributes
idstring | null
namestring | null
avatar_urlstring | null
ratinginteger | null
recommendationstring | null
textstring | null
photosarray of object
Show 1 item attributes
urlstring | null
has_replyboolean
replyobject | null
Show 3 child attributes
external_idstring | null
textstring | null
replied_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
urlstring | null
reviewed_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/reviews/{reviewId}
curl "https://api.socialit.com/v1/inbox/reviews/REVIEW_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Triage a review

PATCH/inbox/reviews/{reviewId}

Access: write

Try it with MCPAsk your agent to call update-review (toolset inbox)Set up MCP

Path parameters

reviewIdstringrequired

Review id (rev_…) or the network review id (with account_id)

1–500 characters

Body object

readboolean
statusstring

openarchived

assignee_idstring | null
labelsarray of string

≤ 20 items

Returns object

objectstring

review

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
location_idstring | null
location_namestring | null
reviewerobject
Show 3 child attributes
idstring | null
namestring | null
avatar_urlstring | null
ratinginteger | null
recommendationstring | null
textstring | null
photosarray of object
Show 1 item attributes
urlstring | null
has_replyboolean
replyobject | null
Show 3 child attributes
external_idstring | null
textstring | null
replied_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
urlstring | null
reviewed_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/inbox/reviews/{reviewId}
curl -X PATCH "https://api.socialit.com/v1/inbox/reviews/REVIEW_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "read": true,
    "status": "open",
    "assignee_id": "string",
    "labels": [
      "string"
    ]
  }'
Response · 200

Reply to a review

POST/inbox/reviews/{reviewId}/reply

Post (or replace) the public reply to a review.

Access: writeIdempotency-KeyZernio: POST /v1/inbox/reviews/{reviewId}/reply

Try it with MCPAsk your agent to call reply-to-review (toolset inbox)Set up MCP

Path parameters

reviewIdstringrequired

Review id (rev_…) or the network review id (with account_id)

1–500 characters

Headers

Idempotency-Keystring

Unique 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

textstringrequired

1–4096 characters

account_idstring

Returns object

objectstring

review

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
location_idstring | null
location_namestring | null
reviewerobject
Show 3 child attributes
idstring | null
namestring | null
avatar_urlstring | null
ratinginteger | null
recommendationstring | null
textstring | null
photosarray of object
Show 1 item attributes
urlstring | null
has_replyboolean
replyobject | null
Show 3 child attributes
external_idstring | null
textstring | null
replied_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
urlstring | null
reviewed_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/reviews/{reviewId}/reply
curl -X POST "https://api.socialit.com/v1/inbox/reviews/REVIEW_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "account_id": "string"
  }'
Response · 200

Delete a review reply

DELETE/inbox/reviews/{reviewId}/reply

Access: writeZernio: DELETE /v1/inbox/reviews/{reviewId}/reply

Try it with MCPAsk your agent to call delete-review-reply (toolset inbox)Set up MCP

Path parameters

reviewIdstringrequired

Review id (rev_…) or the network review id (with account_id)

1–500 characters

Query parameters

account_idstring

Returns object

objectstring

review

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
location_idstring | null
location_namestring | null
reviewerobject
Show 3 child attributes
idstring | null
namestring | null
avatar_urlstring | null
ratinginteger | null
recommendationstring | null
textstring | null
photosarray of object
Show 1 item attributes
urlstring | null
has_replyboolean
replyobject | null
Show 3 child attributes
external_idstring | null
textstring | null
replied_atstring (date-time) | null
statusstring

openarchived

readboolean
assignee_idstring | null
labelsarray of string
urlstring | null
reviewed_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/inbox/reviews/{reviewId}/reply
curl -X DELETE "https://api.socialit.com/v1/inbox/reviews/REVIEW_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Mentions

List mentions

GET/inbox/mentions

Access: readZernio: GET /v1/inbox/mentions

Try it with MCPAsk your agent to call list-mentions (toolset inbox)Set up MCP

Query parameters

pageintegerdefault: 1

Page number

≥ 1

limitintegerdefault: 20

Items per page (max 100)

1–100

sortstring

mentioned_at

orderstring

ascdesc

matchstring

Combine filters with AND (default) or OR

allor

profile_idstring

Only items of this profile (pro_…)

account_idstring

Only items of this account (sa_…)

platformstring

facebookinstagramxlinkedinthreadsblueskypinteresttiktokyoutubegoogle_businessredditsnapchatdiscordmastodontwittergooglebusinessmeta

kindstring

postcommentcaptionstoryreplyquotetag

readboolean
statusstring

openarchived

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 20 item attributes
objectstring

mention

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
kindstring
textstring | null
permalinkstring | null
authorobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
media_idstring | null
comment_idstring | null
repliedboolean
statusstring

openarchived

readboolean
mentioned_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null
pageintegerrequired
limitintegerrequired
totalinteger | null
has_morebooleanrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/mentions
curl "https://api.socialit.com/v1/inbox/mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get a mention

GET/inbox/mentions/{mentionId}

Access: read

Try it with MCPAsk your agent to call get-mention (toolset inbox)Set up MCP

Path parameters

mentionIdstringrequired

Mention id (mtn_…)

1–80 characters

Returns object

objectstring

mention

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
kindstring
textstring | null
permalinkstring | null
authorobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
media_idstring | null
comment_idstring | null
repliedboolean
statusstring

openarchived

readboolean
mentioned_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/mentions/{mentionId}
curl "https://api.socialit.com/v1/inbox/mentions/mtn_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Triage a mention

PATCH/inbox/mentions/{mentionId}

Access: write

Try it with MCPAsk your agent to call update-mention (toolset inbox)Set up MCP

Path parameters

mentionIdstringrequired

Mention id (mtn_…)

1–80 characters

Body object

readboolean
statusstring

openarchived

Returns object

objectstring

mention

idstring
account_idstring | null
profile_idstring | null
platformstring | null
accountobject | null
Show 6 child attributes
idstring
platformstring
usernamestring | null
display_namestring | null
avatar_urlstring | null
profile_idstring | null
external_idstring
kindstring
textstring | null
permalinkstring | null
authorobject | null
Show 5 child attributes
idstring | null
namestring | null
usernamestring | null
avatar_urlstring | null
verified_typestring | null
media_idstring | null
comment_idstring | null
repliedboolean
statusstring

openarchived

readboolean
mentioned_atstring (date-time) | null
metadataobject
created_atstring (date-time) | null
updated_atstring (date-time) | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/inbox/mentions/{mentionId}
curl -X PATCH "https://api.socialit.com/v1/inbox/mentions/mtn_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "read": true,
    "status": "open"
  }'
Response · 200

Reply to a mention

POST/inbox/mentions/reply

Reply to a stored mention (mention_id) or to an Instagram media / comment mention (account_id + media_id [+ comment_id]).

Access: writeIdempotency-KeyZernio: POST /v1/inbox/mentions/reply

Try it with MCPAsk your agent to call reply-to-mention (toolset inbox)Set up MCP

Headers

Idempotency-Keystring

Unique 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

textstringrequired

1–2200 characters

mention_idstring
account_idstring
media_idstring
comment_idstring

Returns object

objectstring

mention_reply

idstring | null
mention_idstring | null
account_idstring
media_idstring | null
comment_idstring | null

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/mentions/reply
curl -X POST "https://api.socialit.com/v1/inbox/mentions/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "mention_id": "string",
    "account_id": "string",
    "media_id": "string",
    "comment_id": "string"
  }'
Response · 201

Counts

Inbox counters

GET/inbox/counts

Unread / open counters for badges.

Access: read

Try it with MCPAsk your agent to call get-inbox-counts (toolset inbox)Set up MCP

Query parameters

profile_idstring
account_idstring

Returns object

objectstring

inbox_counts

conversationsobject
Show 4 child attributes
openinteger
unreadinteger
unassignedinteger
requestsinteger
commentsobject
Show 1 child attributes
unreadinteger
reviewsobject
Show 2 child attributes
unreadinteger
unansweredinteger
mentionsobject
Show 1 child attributes
unreadinteger

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/inbox/counts
curl "https://api.socialit.com/v1/inbox/counts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Sync

Sync the inbox now

POST/inbox/sync

Queue an immediate pull from the networks that are polled (Reddit, YouTube, Bluesky, Mastodon, X, Threads, LinkedIn, Google Business, Facebook reviews, TikTok mentions).

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call sync-inbox (toolset inbox)Set up MCP

Headers

Idempotency-Keystring

Unique 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_idstring
kindsarray of string

unique

Returns object

objectstring

inbox_sync

queuedinteger
accountsarray of string
kindsarray of string

Responses

  • 202Accepted
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/inbox/sync
curl -X POST "https://api.socialit.com/v1/inbox/sync" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "string",
    "kinds": [
      "conversations"
    ]
  }'
Response · 202

Messenger menu

Get persistent menu

GET/accounts/{accountId}/messenger-menu

Read the persistent menu of a Facebook or Instagram account.

Access: readZernio: GET /v1/accounts/{accountId}/messenger-menu

Try it with MCPAsk your agent to call get-messenger-menu (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

messenger_menu

account_idstring
persistent_menuarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/messenger-menu
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Set persistent menu

PATCH/accounts/{accountId}/messenger-menu

Replace the persistent menu of a Facebook or Instagram account.

Access: writeZernio: PUT /v1/accounts/{accountId}/messenger-menu

Try it with MCPAsk your agent to call set-messenger-menu (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Body object

persistent_menuarray of objectrequired

≥ 1 items

Show 3 item attributes
localestringdefault: "default"
composer_input_disabledboolean
call_to_actionsarray of objectrequired

1–20 items

Show 6 item attributes
typestring

postbackweb_urlnested

titlestring

1–30 characters

payloadstring

≤ 1000 characters

urlstring

≤ 2000 characters

webview_height_ratiostring
call_to_actionsarray of object

≤ 5 items

Returns object

objectstring

messenger_menu

account_idstring
persistent_menuarray of object

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/messenger-menu
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "persistent_menu": [
      {
        "locale": "default",
        "call_to_actions": [
          {
            "type": "postback",
            "title": "string"
          }
        ]
      }
    ]
  }'
Response · 200

Delete persistent menu

DELETE/accounts/{accountId}/messenger-menu

Remove the persistent menu from a Facebook or Instagram account.

Access: writeZernio: DELETE /v1/accounts/{accountId}/messenger-menu

Try it with MCPAsk your agent to call delete-messenger-menu (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

messenger_menu

idstring
deletedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/messenger-menu
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Messenger get started

Get Messenger Get Started button

GET/accounts/{accountId}/messenger-get-started

Read the Messenger Get Started button of a Facebook account.

Access: readZernio: GET /v1/accounts/{accountId}/messenger-get-started

Try it with MCPAsk your agent to call get-messenger-get-started (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

messenger_get_started

account_idstring
payloadstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/messenger-get-started
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Set Messenger Get Started button

PATCH/accounts/{accountId}/messenger-get-started

Replace the Messenger Get Started button of a Facebook account.

Access: writeZernio: PUT /v1/accounts/{accountId}/messenger-get-started

Try it with MCPAsk your agent to call set-messenger-get-started (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Body object

payloadstringrequired

1–1000 characters

Returns object

objectstring

messenger_get_started

account_idstring
payloadstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/messenger-get-started
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "string"
  }'
Response · 200

Delete Messenger Get Started button

DELETE/accounts/{accountId}/messenger-get-started

Remove the Messenger Get Started button from a Facebook account.

Access: writeZernio: DELETE /v1/accounts/{accountId}/messenger-get-started

Try it with MCPAsk your agent to call delete-messenger-get-started (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

messenger_get_started

idstring
deletedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/messenger-get-started
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Messenger greeting

Get Messenger greeting text

GET/accounts/{accountId}/messenger-greeting

Read the Messenger greeting text of a Facebook account.

Access: readZernio: GET /v1/accounts/{accountId}/messenger-greeting

Try it with MCPAsk your agent to call get-messenger-greeting (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

messenger_greeting

account_idstring
greetingarray of object
Show 2 item attributes
localestring
textstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/messenger-greeting
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Set Messenger greeting text

PATCH/accounts/{accountId}/messenger-greeting

Replace the Messenger greeting text of a Facebook account.

Access: writeZernio: PUT /v1/accounts/{accountId}/messenger-greeting

Try it with MCPAsk your agent to call set-messenger-greeting (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Body object

greetingarray of objectrequired

≥ 1 items

Show 2 item attributes
localestringrequired

≥ 1 characters

textstringrequired

1–160 characters

Returns object

objectstring

messenger_greeting

account_idstring
greetingarray of object
Show 2 item attributes
localestring
textstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/messenger-greeting
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "greeting": [
      {
        "locale": "en",
        "text": "string"
      }
    ]
  }'
Response · 200

Delete Messenger greeting text

DELETE/accounts/{accountId}/messenger-greeting

Remove the Messenger greeting text from a Facebook account.

Access: writeZernio: DELETE /v1/accounts/{accountId}/messenger-greeting

Try it with MCPAsk your agent to call delete-messenger-greeting (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

messenger_greeting

idstring
deletedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/messenger-greeting
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Messenger ice breakers

Get Messenger ice breakers

GET/accounts/{accountId}/messenger-ice-breakers

Read the Messenger ice breakers of a Facebook account.

Access: readZernio: GET /v1/accounts/{accountId}/messenger-ice-breakers

Try it with MCPAsk your agent to call get-messenger-ice-breakers (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

messenger_ice_breakers

account_idstring
ice_breakersarray of object
Show 2 item attributes
localestring
call_to_actionsarray of object
Show 2 item attributes
questionstring
payloadstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/messenger-ice-breakers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Set Messenger ice breakers

PATCH/accounts/{accountId}/messenger-ice-breakers

Replace the Messenger ice breakers of a Facebook account.

Access: writeZernio: PUT /v1/accounts/{accountId}/messenger-ice-breakers

Try it with MCPAsk your agent to call set-messenger-ice-breakers (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Body object

ice_breakersarray of objectrequired

≥ 1 items

Show 2 item attributes
localestringrequired

≥ 1 characters

call_to_actionsarray of objectrequired

1–4 items

Show 2 item attributes
questionstringrequired

1–80 characters

payloadstringrequired

1–1000 characters

Returns object

objectstring

messenger_ice_breakers

account_idstring
ice_breakersarray of object
Show 2 item attributes
localestring
call_to_actionsarray of object
Show 2 item attributes
questionstring
payloadstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/messenger-ice-breakers
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ice_breakers": [
      {
        "locale": "en",
        "call_to_actions": [
          {
            "question": "string",
            "payload": "string"
          }
        ]
      }
    ]
  }'
Response · 200

Delete Messenger ice breakers

DELETE/accounts/{accountId}/messenger-ice-breakers

Remove the Messenger ice breakers from a Facebook account.

Access: writeZernio: DELETE /v1/accounts/{accountId}/messenger-ice-breakers

Try it with MCPAsk your agent to call delete-messenger-ice-breakers (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

messenger_ice_breakers

idstring
deletedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/messenger-ice-breakers
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Instagram ice breakers

Get Instagram ice breakers

GET/accounts/{accountId}/instagram-ice-breakers

Read the Instagram ice breakers of a Instagram account.

Access: readZernio: GET /v1/accounts/{accountId}/instagram-ice-breakers

Try it with MCPAsk your agent to call get-instagram-ice-breakers (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

instagram_ice_breakers

account_idstring
ice_breakersarray of object
Show 2 item attributes
questionstring
payloadstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/instagram-ice-breakers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Set Instagram ice breakers

PATCH/accounts/{accountId}/instagram-ice-breakers

Replace the Instagram ice breakers of a Instagram account.

Access: writeZernio: PUT /v1/accounts/{accountId}/instagram-ice-breakers

Try it with MCPAsk your agent to call set-instagram-ice-breakers (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Body object

ice_breakersarray of objectrequired

1–4 items

Show 2 item attributes
questionstringrequired

1–80 characters

payloadstringrequired

1–1000 characters

Returns object

objectstring

instagram_ice_breakers

account_idstring
ice_breakersarray of object
Show 2 item attributes
questionstring
payloadstring

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/instagram-ice-breakers
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ice_breakers": [
      {
        "question": "string",
        "payload": "string"
      }
    ]
  }'
Response · 200

Delete Instagram ice breakers

DELETE/accounts/{accountId}/instagram-ice-breakers

Remove the Instagram ice breakers from a Instagram account.

Access: writeZernio: DELETE /v1/accounts/{accountId}/instagram-ice-breakers

Try it with MCPAsk your agent to call delete-instagram-ice-breakers (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Returns object

objectstring

instagram_ice_breakers

idstring
deletedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/instagram-ice-breakers
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

X

Repost (retweet) a post on X

POST/accounts/{accountId}/x/retweets

Access: writeIdempotency-KeyZernio: POST /v1/twitter/retweet

Try it with MCPAsk your agent to call retweet (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

1–300 characters

Returns object

objectstring

x_retweet

account_idstring
tweet_idstring
retweetedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/retweets
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/retweets" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "tweet_id": "string"
  }'
Response · 200

Undo a repost on X

DELETE/accounts/{accountId}/x/retweets/{tweetId}

Access: writeZernio: DELETE /v1/twitter/retweet

Try it with MCPAsk your agent to call unretweet (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

tweetIdstringrequired

1–300 characters

Returns object

objectstring

x_retweet

account_idstring
tweet_idstring
retweetedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/x/retweets/{tweetId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/retweets/TWEET_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Bookmark a post on X

POST/accounts/{accountId}/x/bookmarks

Access: writeIdempotency-KeyZernio: POST /v1/twitter/bookmark

Try it with MCPAsk your agent to call bookmark-tweet (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

1–300 characters

Returns object

objectstring

x_bookmark

account_idstring
tweet_idstring
bookmarkedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/bookmarks
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/bookmarks" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "tweet_id": "string"
  }'
Response · 200

Remove an X bookmark

DELETE/accounts/{accountId}/x/bookmarks/{tweetId}

Access: writeZernio: DELETE /v1/twitter/bookmark

Try it with MCPAsk your agent to call remove-bookmark (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

tweetIdstringrequired

1–300 characters

Returns object

objectstring

x_bookmark

account_idstring
tweet_idstring
bookmarkedboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/x/bookmarks/{tweetId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/bookmarks/TWEET_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Follow a user on X

POST/accounts/{accountId}/x/following

Follow (or request to follow a protected account). Requires X Enterprise access: otherwise 402 enterprise_required.

Access: writeIdempotency-KeyZernio: POST /v1/twitter/follow

Try it with MCPAsk your agent to call follow-x-user (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired

1–64 characters

Returns object

objectstring

x_follow

account_idstring
target_user_idstring
followingboolean
pending_followboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/x/following
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "target_user_id": "string"
  }'
Response · 200

Unfollow a user on X

DELETE/accounts/{accountId}/x/following/{targetUserId}

Access: writeZernio: DELETE /v1/twitter/follow

Try it with MCPAsk your agent to call unfollow-x-user (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

targetUserIdstringrequired

1–64 characters

Returns object

objectstring

x_follow

account_idstring
target_user_idstring
followingboolean
pending_followboolean

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/x/following/{targetUserId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/TARGET_USER_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Search recent posts on X

GET/accounts/{accountId}/x/search

Posts from the last 7 days matching an X search query (operators passed through).

Access: readZernio: GET /v1/twitter/search

Try it with MCPAsk your agent to call search-tweets (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Query parameters

querystringrequired

1–512 characters

limitintegerdefault: 10

10–100

since_idstring

pattern ^[0-9]+$

until_idstring

pattern ^[0-9]+$

start_timestring (date-time)
end_timestring (date-time)
cursorstring
sort_orderstring

recencyrelevancy

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
objectstring

tweet

idstring
textstring | null
created_atstring (date-time) | null
conversation_idstring | null
in_reply_to_tweet_idstring | null
langstring | null
authorobject
Show 5 child attributes
idstring | null
usernamestring | null
namestring | null
avatar_urlstring | null
verified_typestring | null
like_countinteger
reply_countinteger
retweet_countinteger
quote_countinteger
urlstring | null
limitinteger
has_morebooleanrequired
next_cursorstring | null
previous_cursorstring | null
metaobject
Show 3 child attributes
result_countinteger
newest_idstring | null
oldest_idstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/x/search
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/search?query=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Look up a post on X

GET/accounts/{accountId}/x/tweets/{tweetId}

tweetId is the numeric id or a URL-encoded post URL.

Access: readZernio: GET /v1/twitter/tweet

Try it with MCPAsk your agent to call get-tweet (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

tweetIdstringrequired

1–300 characters

Returns object

objectstring

tweet

idstring
textstring | null
created_atstring (date-time) | null
conversation_idstring | null
in_reply_to_tweet_idstring | null
langstring | null
authorobject
Show 5 child attributes
idstring | null
usernamestring | null
namestring | null
avatar_urlstring | null
verified_typestring | null
like_countinteger
reply_countinteger
retweet_countinteger
quote_countinteger
urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/x/tweets/{tweetId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/tweets/TWEET_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Reddit

Search Reddit posts

GET/accounts/{accountId}/reddit/search

Access: readZernio: GET /v1/reddit/search

Try it with MCPAsk your agent to call search-reddit (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Query parameters

qstringrequired

1–512 characters

subredditstring

≤ 100 characters

restrict_srboolean
sortstring

relevancehottopnewcomments

tstring

hourdayweekmonthyearall

limitintegerdefault: 25

1–100

afterstring
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 17 item attributes
objectstring

reddit_post

idstring
fullnamestring | null
titlestring | null
authorstring | null
subredditstring | null
urlstring | null
permalinkstring | null
selftextstring | null
created_atstring (date-time) | null
scoreinteger
num_commentsinteger
over_18boolean
stickiedboolean
flair_textstring | null
is_galleryboolean
gallery_imagesarray of string
limitinteger
has_morebooleanrequired
next_cursorstring | null
previous_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/reddit/search
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get a subreddit feed

GET/accounts/{accountId}/reddit/feed

Access: readZernio: GET /v1/reddit/feed

Try it with MCPAsk your agent to call get-reddit-feed (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

Query parameters

subredditstring

≤ 100 characters

sortstring

hotnewtoprising

tstring

hourdayweekmonthyearall

limitintegerdefault: 25

1–100

afterstring
cursorstring

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 17 item attributes
objectstring

reddit_post

idstring
fullnamestring | null
titlestring | null
authorstring | null
subredditstring | null
urlstring | null
permalinkstring | null
selftextstring | null
created_atstring (date-time) | null
scoreinteger
num_commentsinteger
over_18boolean
stickiedboolean
flair_textstring | null
is_galleryboolean
gallery_imagesarray of string
limitinteger
has_morebooleanrequired
next_cursorstring | null
previous_cursorstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/reddit/feed
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Get a Reddit post's comments

GET/accounts/{accountId}/reddit/posts/{postId}/comments

Access: readZernio: GET /v1/reddit/comments/{postId}

Try it with MCPAsk your agent to call get-reddit-post-comments (toolset inbox)Set up MCP

Path parameters

accountIdstringrequired

Account id (sa_…)

1–80 characters

postIdstringrequired

1–64 characters

Query parameters

sortstring

newtopbestcontroversialoldqa

limitintegerdefault: 25

1–500

comment_idstring

≤ 64 characters

Returns object

objectstring

reddit_comment_thread

postobject | null
dataarray of object
Show 15 item attributes
objectstring

reddit_comment

idstring
fullnamestring | null
parent_idstring | null
authorstring | null
bodystring | null
permalinkstring | null
created_atstring (date-time) | null
scoreinteger
num_repliesinteger
depthinteger
is_submitterboolean
editedboolean
stickiedboolean
distinguishedstring | null
morearray of string

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/reddit/posts/{postId}/comments
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/posts/POST_ID/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200