# Inbox API

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

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## 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: `read` · MCP tool: `list-conversations` · Zernio: `GET /v1/inbox/conversations`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of last_message_at, created_at, unread_count)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string): Only items of this profile (pro_…)
- `account_id` (string): Only items of this account (sa_…)
- `platform` (string; one of facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, …)
- `status` (string; one of open, active, archived, snoozed)
- `folder` (string; one of inbox, requests)
- `assignee_id` (string): usr_… or "none" for unassigned
- `label` (string)
- `unread` (boolean)
- `q` (string; ≤ 200 characters): Participant name / username contains

```bash
curl "https://api.socialit.com/v1/inbox/conversations" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "conversation",
      "id": "string",
      "account_id": "string",
      "profile_id": "string",
      "platform": "string",
      "account": {
        "id": "string",
        "platform": "string",
        "username": "string",
        "display_name": "string",
        "avatar_url": "https://example.com",
        "profile_id": "string"
      },
      "external_id": "string",
      "participant": {
        "id": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "verified_type": "string"
      },
      "is_group": true,
      "folder": "inbox",
      "status": "open",
      "snoozed_until": "2026-10-13T09:00:00.000Z",
      "unread_count": 1,
      "assignee_id": "string",
      "labels": [
        "string"
      ],
      "thread_owner": "string",
      "contact_id": "string",
      "last_message_preview": "string",
      "last_message_direction": "inbound",
      "last_message_at": "2026-10-13T09:00:00.000Z",
      "last_inbound_at": "2026-10-13T09:00:00.000Z",
      "url": "https://example.com",
      "metadata": {},
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `create-conversation` · Zernio: `POST /v1/inbox/conversations`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `participant_id` (string; 1–300 characters)
- `participant_username` (string; 1–300 characters)
- `text` (string; 1–20000 characters)
- `media_ids` (array of string; ≤ 10 items)
- `attachment_url` (string (uri))
- `attachment_type` (string; one of image, video, audio, file)
- `skip_dm_check` (boolean)
- `template` (object)
  - `template.name` (string; required; ≥ 1 characters)
  - `template.language` (string)
  - `template.params` (array of string)
  - `template.button_params` (array of object)
  - `template.cards` (array of object)
  - `template.header_media` (object)
  - `template.header_location` (object)
- `category` (string; one of utility, marketing, authentication)
- `link_preview` (boolean)

```bash
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:

```json
{
  "object": "conversation",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "participant": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "is_group": true,
  "folder": "inbox",
  "status": "open",
  "snoozed_until": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "thread_owner": "string",
  "contact_id": "string",
  "last_message_preview": "string",
  "last_message_direction": "inbound",
  "last_message_at": "2026-10-13T09:00:00.000Z",
  "last_inbound_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z",
  "sent_message": {
    "object": "message",
    "id": "string",
    "conversation_id": "string",
    "account_id": "string",
    "platform": "string",
    "external_id": "string",
    "direction": "inbound",
    "text": "string",
    "sender": {
      "id": "string",
      "name": "string",
      "username": "string",
      "avatar_url": "https://example.com",
      "verified_type": "string"
    },
    "attachments": [
      {
        "index": 1,
        "type": "string",
        "url": "https://example.com",
        "mime_type": "string",
        "filename": "string",
        "size": 1
      }
    ],
    "status": "string",
    "error": {
      "code": "string",
      "message": "string"
    },
    "reactions": [
      {
        "emoji": "string",
        "from_me": true,
        "sender_id": "string",
        "reacted_at": "2026-10-13T09:00:00.000Z"
      }
    ],
    "reply_to_id": "string",
    "reply_to_external_id": "string",
    "is_edited": true,
    "edited_at": "2026-10-13T09:00:00.000Z",
    "edit_count": 1,
    "edit_history": [
      {
        "text": "string",
        "edited_at": "2026-10-13T09:00:00.000Z"
      }
    ],
    "is_deleted": true,
    "deleted_at": "2026-10-13T09:00:00.000Z",
    "sent_via": "string",
    "sent_by_user_id": "string",
    "sent_at": "2026-10-13T09:00:00.000Z",
    "delivered_at": "2026-10-13T09:00:00.000Z",
    "read_at": "2026-10-13T09:00:00.000Z",
    "metadata": {},
    "created_at": "2026-10-13T09:00:00.000Z",
    "updated_at": "2026-10-13T09:00:00.000Z"
  }
}
```

## 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: `read` · MCP tool: `search-conversations` · Zernio: `GET /v1/inbox/conversations/search`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string): Only items of this profile (pro_…)
- `account_id` (string): Only items of this account (sa_…)
- `platform` (string; one of facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, …)
- `q` (string; 1–200 characters): Text to search in messages and participant identity
- `query` (string; 1–200 characters): Alias of q (Zernio)
- `direction` (string; one of inbound, outbound, incoming, outgoing)

```bash
curl "https://api.socialit.com/v1/inbox/conversations/search" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "conversation_search_result",
      "conversation": {
        "object": "conversation",
        "id": "string",
        "account_id": "string",
        "profile_id": "string",
        "platform": "string",
        "account": {
          "id": "string",
          "platform": "string",
          "username": "string",
          "display_name": "string",
          "avatar_url": "https://example.com",
          "profile_id": "string"
        }
      },
      "match_count": 1,
      "matches": [
        {
          "id": "string",
          "text": "string",
          "direction": "inbound",
          "sent_at": "2026-10-13T09:00:00.000Z"
        }
      ]
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Get a conversation

`GET /inbox/conversations/{conversationId}`

Access: `read` · MCP tool: `get-conversation` · Zernio: `GET /v1/inbox/conversations/{conversationId}`

### Path parameters

- `conversationId` (string; required; 1–80 characters): Conversation id (conv_…)

```bash
curl "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "conversation",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "participant": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "is_group": true,
  "folder": "inbox",
  "status": "open",
  "snoozed_until": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "thread_owner": "string",
  "contact_id": "string",
  "last_message_preview": "string",
  "last_message_direction": "inbound",
  "last_message_at": "2026-10-13T09:00:00.000Z",
  "last_inbound_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `update-conversation` · Zernio: `PUT /v1/inbox/conversations/{conversationId}`

### Path parameters

- `conversationId` (string; required; 1–80 characters): Conversation id (conv_…)

### Body

- `status` (string; one of open, active, archived, snoozed)
- `snoozed_until` (string (date-time) | null)
- `assignee_id` (string | null)
- `labels` (array of string; ≤ 20 items)
- `contact_id` (string | null)
- `account_id` (string): Ignored (Zernio compatibility)

```bash
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:

```json
{
  "object": "conversation",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "participant": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "is_group": true,
  "folder": "inbox",
  "status": "open",
  "snoozed_until": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "thread_owner": "string",
  "contact_id": "string",
  "last_message_preview": "string",
  "last_message_direction": "inbound",
  "last_message_at": "2026-10-13T09:00:00.000Z",
  "last_inbound_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `accept-conversation` · Zernio: `POST /v1/inbox/conversations/{conversationId}/accept`

### Path parameters

- `conversationId` (string; required; 1–80 characters): Conversation id (conv_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; required; 1–20000 characters)
- `account_id` (string)

```bash
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:

```json
{
  "object": "message",
  "id": "string",
  "conversation_id": "string",
  "account_id": "string",
  "platform": "string",
  "external_id": "string",
  "direction": "inbound",
  "text": "string",
  "sender": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "attachments": [
    {
      "index": 1,
      "type": "string",
      "url": "https://example.com",
      "mime_type": "string",
      "filename": "string",
      "size": 1,
      "preview_url": "https://example.com",
      "media_id": "string",
      "refresh_url": "https://example.com"
    }
  ],
  "status": "string",
  "error": {
    "code": "string",
    "message": "string"
  },
  "reactions": [
    {
      "emoji": "string",
      "from_me": true,
      "sender_id": "string",
      "reacted_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "reply_to_id": "string",
  "reply_to_external_id": "string",
  "is_edited": true,
  "edited_at": "2026-10-13T09:00:00.000Z",
  "edit_count": 1,
  "edit_history": [
    {
      "text": "string",
      "edited_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "sent_via": "string",
  "sent_by_user_id": "string",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "delivered_at": "2026-10-13T09:00:00.000Z",
  "read_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `mark-conversation-read` · Zernio: `POST /v1/inbox/conversations/{conversationId}/read`

### Path parameters

- `conversationId` (string; required; 1–80 characters): Conversation id (conv_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `account_id` (string)

```bash
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:

```json
{
  "object": "conversation",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "participant": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "is_group": true,
  "folder": "inbox",
  "status": "open",
  "snoozed_until": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "thread_owner": "string",
  "contact_id": "string",
  "last_message_preview": "string",
  "last_message_direction": "inbound",
  "last_message_at": "2026-10-13T09:00:00.000Z",
  "last_inbound_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Mark a conversation as unread

`POST /inbox/conversations/{conversationId}/unread`

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

Access: `write` · MCP tool: `mark-conversation-unread`

### Path parameters

- `conversationId` (string; required; 1–80 characters): Conversation id (conv_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "conversation",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "participant": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "is_group": true,
  "folder": "inbox",
  "status": "open",
  "snoozed_until": "2026-10-13T09:00:00.000Z",
  "unread_count": 1,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "thread_owner": "string",
  "contact_id": "string",
  "last_message_preview": "string",
  "last_message_direction": "inbound",
  "last_message_at": "2026-10-13T09:00:00.000Z",
  "last_inbound_at": "2026-10-13T09:00:00.000Z",
  "url": "https://example.com",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Send a typing indicator

`POST /inbox/conversations/{conversationId}/typing`

Access: `write` · MCP tool: `send-typing-indicator` · Zernio: `POST /v1/inbox/conversations/{conversationId}/typing`

### Path parameters

- `conversationId` (string; required; 1–80 characters): Conversation id (conv_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `account_id` (string)

```bash
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:

```json
{
  "object": "typing_indicator",
  "conversation_id": "string",
  "sent": true
}
```

## Change who answers a conversation

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

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

Access: `write` · MCP tool: `change-thread-control` · Zernio: `POST /v1/inbox/conversations/{conversationId}/thread-control`

### Path parameters

- `conversationId` (string; required; 1–80 characters): Conversation id (conv_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `action` (string; required; one of release, take, pass, request)
- `target` (string; one of ai_agent)
- `target_app_id` (string; ≤ 100 characters)
- `metadata` (string; ≤ 1000 characters)
- `account_id` (string)

```bash
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:

```json
{
  "object": "thread_control",
  "conversation_id": "string",
  "owner": "string",
  "owner_app_id": "string"
}
```

## 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: `read` · MCP tool: `list-messages` · Zernio: `GET /v1/inbox/conversations/{conversationId}/messages`

### Path parameters

- `conversationId` (string; required; 1–80 characters): Conversation id (conv_…)

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of sent_at)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `direction` (string; one of inbound, outbound)
- `refresh` (boolean): Pull the latest messages from the network first

```bash
curl "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "message",
      "id": "string",
      "conversation_id": "string",
      "account_id": "string",
      "platform": "string",
      "external_id": "string",
      "direction": "inbound",
      "text": "string",
      "sender": {
        "id": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "verified_type": "string"
      },
      "attachments": [
        {
          "index": 1,
          "type": "string",
          "url": "https://example.com",
          "mime_type": "string",
          "filename": "string",
          "size": 1
        }
      ],
      "status": "string",
      "error": {
        "code": "string",
        "message": "string"
      },
      "reactions": [
        {
          "emoji": "string",
          "from_me": true,
          "sender_id": "string",
          "reacted_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "reply_to_id": "string",
      "reply_to_external_id": "string",
      "is_edited": true,
      "edited_at": "2026-10-13T09:00:00.000Z",
      "edit_count": 1,
      "edit_history": [
        {
          "text": "string",
          "edited_at": "2026-10-13T09:00:00.000Z"
        }
      ],
      "is_deleted": true,
      "deleted_at": "2026-10-13T09:00:00.000Z",
      "sent_via": "string",
      "sent_by_user_id": "string",
      "sent_at": "2026-10-13T09:00:00.000Z",
      "delivered_at": "2026-10-13T09:00:00.000Z",
      "read_at": "2026-10-13T09:00:00.000Z",
      "metadata": {},
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `send-message` · Zernio: `POST /v1/inbox/conversations/{conversationId}/messages`

### Path parameters

- `conversationId` (string; required; 1–80 characters): Conversation id (conv_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; 1–20000 characters)
- `media_ids` (array of string; ≤ 10 items)
- `attachment_url` (string (uri))
- `attachment_type` (string; one of image, video, audio, file)
- `attachment_name` (string; ≤ 255 characters)
- `quick_replies` (array of object; ≤ 13 items)
  - `quick_replies[].title` (string; required; 1–20 characters)
  - `quick_replies[].payload` (string; required; ≤ 1000 characters)
  - `quick_replies[].image_url` (string)
- `buttons` (array of object; ≤ 3 items)
  - `buttons[].type` (string; required; one of url, postback, phone)
  - `buttons[].title` (string; required; 1–20 characters)
  - `buttons[].url` (string)
  - `buttons[].payload` (string)
  - `buttons[].phone` (string)
- `template` (object)
- `messaging_type` (string; one of RESPONSE, UPDATE, MESSAGE_TAG)
- `message_tag` (string; one of CONFIRMED_EVENT_UPDATE, POST_PURCHASE_UPDATE, ACCOUNT_UPDATE, HUMAN_AGENT)
- `reply_to` (string; ≤ 300 characters)
- `subject` (string; ≤ 300 characters)
- `account_id` (string): Ignored (Zernio compatibility)

```bash
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:

```json
{
  "object": "message",
  "id": "string",
  "conversation_id": "string",
  "account_id": "string",
  "platform": "string",
  "external_id": "string",
  "direction": "inbound",
  "text": "string",
  "sender": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "attachments": [
    {
      "index": 1,
      "type": "string",
      "url": "https://example.com",
      "mime_type": "string",
      "filename": "string",
      "size": 1,
      "preview_url": "https://example.com",
      "media_id": "string",
      "refresh_url": "https://example.com"
    }
  ],
  "status": "string",
  "error": {
    "code": "string",
    "message": "string"
  },
  "reactions": [
    {
      "emoji": "string",
      "from_me": true,
      "sender_id": "string",
      "reacted_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "reply_to_id": "string",
  "reply_to_external_id": "string",
  "is_edited": true,
  "edited_at": "2026-10-13T09:00:00.000Z",
  "edit_count": 1,
  "edit_history": [
    {
      "text": "string",
      "edited_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "sent_via": "string",
  "sent_by_user_id": "string",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "delivered_at": "2026-10-13T09:00:00.000Z",
  "read_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Delete a message

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

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

Access: `write` · MCP tool: `delete-message` · Zernio: `DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}`

### Path parameters

- `conversationId` (string; required; 1–80 characters): conversation id (conv_…)
- `messageId` (string; required; 1–500 characters): Message id (msg_…) or the network message id

```bash
curl -X DELETE "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages/MESSAGE_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "message",
  "id": "string",
  "deleted": true
}
```

## React to a message

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

Access: `write` · MCP tool: `add-message-reaction` · Zernio: `POST /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions`

### Path parameters

- `conversationId` (string; required; 1–80 characters): conversation id (conv_…)
- `messageId` (string; required; 1–500 characters): Message id (msg_…) or the network message id

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `emoji` (string; required; 1–64 characters)
- `account_id` (string)

```bash
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:

```json
{
  "object": "message",
  "id": "string",
  "conversation_id": "string",
  "account_id": "string",
  "platform": "string",
  "external_id": "string",
  "direction": "inbound",
  "text": "string",
  "sender": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "attachments": [
    {
      "index": 1,
      "type": "string",
      "url": "https://example.com",
      "mime_type": "string",
      "filename": "string",
      "size": 1,
      "preview_url": "https://example.com",
      "media_id": "string",
      "refresh_url": "https://example.com"
    }
  ],
  "status": "string",
  "error": {
    "code": "string",
    "message": "string"
  },
  "reactions": [
    {
      "emoji": "string",
      "from_me": true,
      "sender_id": "string",
      "reacted_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "reply_to_id": "string",
  "reply_to_external_id": "string",
  "is_edited": true,
  "edited_at": "2026-10-13T09:00:00.000Z",
  "edit_count": 1,
  "edit_history": [
    {
      "text": "string",
      "edited_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "sent_via": "string",
  "sent_by_user_id": "string",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "delivered_at": "2026-10-13T09:00:00.000Z",
  "read_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Remove a reaction

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

Access: `write` · MCP tool: `remove-message-reaction` · Zernio: `DELETE /v1/inbox/conversations/{conversationId}/messages/{messageId}/reactions`

### Path parameters

- `conversationId` (string; required; 1–80 characters): conversation id (conv_…)
- `messageId` (string; required; 1–500 characters): Message id (msg_…) or the network message id

### Query parameters

- `emoji` (string; ≤ 64 characters)
- `account_id` (string)

```bash
curl -X DELETE "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages/MESSAGE_ID/reactions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "message",
  "id": "string",
  "conversation_id": "string",
  "account_id": "string",
  "platform": "string",
  "external_id": "string",
  "direction": "inbound",
  "text": "string",
  "sender": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "attachments": [
    {
      "index": 1,
      "type": "string",
      "url": "https://example.com",
      "mime_type": "string",
      "filename": "string",
      "size": 1,
      "preview_url": "https://example.com",
      "media_id": "string",
      "refresh_url": "https://example.com"
    }
  ],
  "status": "string",
  "error": {
    "code": "string",
    "message": "string"
  },
  "reactions": [
    {
      "emoji": "string",
      "from_me": true,
      "sender_id": "string",
      "reacted_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "reply_to_id": "string",
  "reply_to_external_id": "string",
  "is_edited": true,
  "edited_at": "2026-10-13T09:00:00.000Z",
  "edit_count": 1,
  "edit_history": [
    {
      "text": "string",
      "edited_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "sent_via": "string",
  "sent_by_user_id": "string",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "delivered_at": "2026-10-13T09:00:00.000Z",
  "read_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `read` · MCP tool: `get-message-attachment` · Zernio: `GET /v1/inbox/conversations/{conversationId}/messages/{messageId}/attachments/{index}`

### Path parameters

- `conversationId` (string; required; 1–80 characters): conversation id (conv_…)
- `messageId` (string; required; 1–500 characters): Message id
- `index` (integer; required; 0–50)

### Query parameters

- `format` (string; one of redirect, json)
- `account_id` (string)

```bash
curl "https://api.socialit.com/v1/inbox/conversations/conv_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messages/MESSAGE_ID/attachments/INDEX" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "message_attachment",
  "message_id": "string",
  "index": 1,
  "type": "string",
  "url": "https://example.com",
  "mime_type": "string",
  "refreshed": true
}
```

## List posts with comments

`GET /inbox/posts`

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

Access: `read` · MCP tool: `list-inbox-posts` · Zernio: `GET /v1/inbox/comments`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of last_comment_at, published_at, comment_count)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string): Only items of this profile (pro_…)
- `account_id` (string): Only items of this account (sa_…)
- `platform` (string; one of facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, …)
- `min_comments` (integer)
- `since` (string (date-time))
- `unread` (boolean)

```bash
curl "https://api.socialit.com/v1/inbox/posts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "inbox_post",
      "id": "string",
      "account_id": "string",
      "profile_id": "string",
      "platform": "string",
      "account": {
        "id": "string",
        "platform": "string",
        "username": "string",
        "display_name": "string",
        "avatar_url": "https://example.com",
        "profile_id": "string"
      },
      "external_id": "string",
      "post_id": "string",
      "content": "string",
      "picture_url": "https://example.com",
      "permalink": "string",
      "published_at": "2026-10-13T09:00:00.000Z",
      "comment_count": 1,
      "unread_comment_count": 1,
      "like_count": 1,
      "last_comment_at": "2026-10-13T09:00:00.000Z",
      "cid": "string",
      "subreddit": "string",
      "is_ad": true,
      "ad_id": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Get a commented post

`GET /inbox/posts/{postId}`

Access: `read` · MCP tool: `get-inbox-post`

### Path parameters

- `postId` (string; required; 1–500 characters): Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

### Query parameters

- `account_id` (string)

```bash
curl "https://api.socialit.com/v1/inbox/posts/POST_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "inbox_post",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "post_id": "string",
  "content": "string",
  "picture_url": "https://example.com",
  "permalink": "string",
  "published_at": "2026-10-13T09:00:00.000Z",
  "comment_count": 1,
  "unread_comment_count": 1,
  "like_count": 1,
  "last_comment_at": "2026-10-13T09:00:00.000Z",
  "cid": "string",
  "subreddit": "string",
  "is_ad": true,
  "ad_id": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `read` · MCP tool: `list-post-comments` · Zernio: `GET /v1/inbox/comments/{postId}`

### Path parameters

- `postId` (string; required; 1–500 characters): Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of commented_at)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `account_id` (string)
- `comment_id` (string): Only replies of this comment (cmt_… or network id)
- `subreddit` (string)
- `refresh` (boolean): Fetch from the network first (default true)

```bash
curl "https://api.socialit.com/v1/inbox/posts/POST_ID/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "comment",
      "id": "string",
      "account_id": "string",
      "profile_id": "string",
      "platform": "string",
      "inbox_post_id": "string",
      "post_id": "string",
      "external_post_id": "string",
      "external_id": "string",
      "parent_id": "string",
      "external_parent_id": "string",
      "is_reply": true,
      "author": {
        "id": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "verified_type": "string",
        "is_owner": true
      },
      "text": "string",
      "attachments": [
        {
          "type": "string",
          "url": "https://example.com"
        }
      ],
      "like_count": 1,
      "reply_count": 1,
      "is_hidden": true,
      "is_pinned": true,
      "is_liked": true,
      "like_uri": "string",
      "cid": "string",
      "moderation_status": "string",
      "is_edited": true,
      "is_deleted": true,
      "deleted_at": "2026-10-13T09:00:00.000Z",
      "status": "open",
      "read": true,
      "assignee_id": "string",
      "labels": [
        "string"
      ]
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Comment on a post or reply to a comment

`POST /inbox/posts/{postId}/comments`

Access: `write` · MCP tool: `create-comment` · Zernio: `POST /v1/inbox/comments/{postId}`

### Path parameters

- `postId` (string; required; 1–500 characters): Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `account_id` (string)
- `text` (string; required; 1–10000 characters)
- `comment_id` (string): Reply to this comment (cmt_… or network id)
- `attachment_url` (string (uri))
- `media_ids` (array of string; ≤ 10 items)
- `parent_cid` (string)
- `root_uri` (string)
- `root_cid` (string)

```bash
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:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `like-post` · Zernio: `POST /v1/inbox/posts/{postId}/like`

### Path parameters

- `postId` (string; required; 1–500 characters): Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `reaction_type` (string; one of LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT)
- `cid` (string)

```bash
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:

```json
{
  "object": "post_like",
  "post_id": "string",
  "external_post_id": "string",
  "account_id": "string",
  "liked": true,
  "like_uri": "string",
  "already_reacted": true,
  "reaction_type": "string"
}
```

## Unlike a post

`DELETE /inbox/posts/{postId}/like`

Access: `write` · MCP tool: `unlike-post` · Zernio: `DELETE /v1/inbox/posts/{postId}/like`

### Path parameters

- `postId` (string; required; 1–500 characters): Inbox post id (inp_…), Socialit post id (pst_…) or the network post id (with account_id)

### Query parameters

- `account_id` (string; required; 1–80 characters): Account id (sa_…)
- `like_uri` (string)

```bash
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:

```json
{
  "object": "post_like",
  "post_id": "string",
  "external_post_id": "string",
  "account_id": "string",
  "liked": true,
  "like_uri": "string",
  "already_reacted": true,
  "reaction_type": "string"
}
```

## List comments

`GET /inbox/comments`

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

Access: `read` · MCP tool: `list-comments`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of commented_at, like_count)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string): Only items of this profile (pro_…)
- `account_id` (string): Only items of this account (sa_…)
- `platform` (string; one of facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, …)
- `inbox_post_id` (string)
- `status` (string; one of open, archived)
- `read` (boolean)
- `hidden` (boolean)
- `assignee_id` (string)
- `label` (string)
- `is_owner` (boolean)

```bash
curl "https://api.socialit.com/v1/inbox/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "comment",
      "id": "string",
      "account_id": "string",
      "profile_id": "string",
      "platform": "string",
      "inbox_post_id": "string",
      "post_id": "string",
      "external_post_id": "string",
      "external_id": "string",
      "parent_id": "string",
      "external_parent_id": "string",
      "is_reply": true,
      "author": {
        "id": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "verified_type": "string",
        "is_owner": true
      },
      "text": "string",
      "attachments": [
        {
          "type": "string",
          "url": "https://example.com"
        }
      ],
      "like_count": 1,
      "reply_count": 1,
      "is_hidden": true,
      "is_pinned": true,
      "is_liked": true,
      "like_uri": "string",
      "cid": "string",
      "moderation_status": "string",
      "is_edited": true,
      "is_deleted": true,
      "deleted_at": "2026-10-13T09:00:00.000Z",
      "status": "open",
      "read": true,
      "assignee_id": "string",
      "labels": [
        "string"
      ]
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Get a comment

`GET /inbox/comments/{commentId}`

Access: `read` · MCP tool: `get-comment`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Query parameters

- `account_id` (string)
- `like_uri` (string)
- `post_id` (string)

```bash
curl "https://api.socialit.com/v1/inbox/comments/COMMENT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `update-comment` · Zernio: `PATCH /v1/inbox/comments/{postId}/{commentId}`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Body

- `text` (string; 1–10000 characters)
- `content` (string; 1–10000 characters)
- `read` (boolean)
- `status` (string; one of open, archived)
- `assignee_id` (string | null)
- `labels` (array of string; ≤ 20 items)
- `account_id` (string)
- `platform` (string): Ignored (Zernio compatibility)

```bash
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:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Delete a comment

`DELETE /inbox/comments/{commentId}`

Access: `write` · MCP tool: `delete-comment` · Zernio: `DELETE /v1/inbox/comments/{postId}`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Query parameters

- `account_id` (string)
- `like_uri` (string)
- `post_id` (string)

```bash
curl -X DELETE "https://api.socialit.com/v1/inbox/comments/COMMENT_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "comment",
  "id": "string",
  "deleted": true
}
```

## Reply to a comment

`POST /inbox/comments/{commentId}/replies`

Access: `write` · MCP tool: `reply-to-comment`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; required; 1–10000 characters)
- `attachment_url` (string (uri))
- `media_ids` (array of string; ≤ 10 items)
- `account_id` (string)

```bash
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:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Set comment moderation status

`POST /inbox/comments/{commentId}/moderation`

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

Access: `write` · MCP tool: `set-comment-moderation` · Zernio: `POST /v1/inbox/comments/{postId}/{commentId}/moderation`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `moderation_status` (string; required; one of published, rejected, held_for_review, heldForReview)
- `ban_author` (boolean)
- `account_id` (string)
- `platform` (string)

```bash
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:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Hide a comment

`POST /inbox/comments/{commentId}/hide`

Access: `write` · MCP tool: `hide-comment` · Zernio: `POST /v1/inbox/comments/{postId}/{commentId}/hide`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `account_id` (string)
- `post_id` (string)

```bash
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:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Unhide a comment

`DELETE /inbox/comments/{commentId}/hide`

Access: `write` · MCP tool: `unhide-comment` · Zernio: `DELETE /v1/inbox/comments/{postId}/{commentId}/hide`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Query parameters

- `account_id` (string)
- `like_uri` (string)
- `post_id` (string)

```bash
curl -X DELETE "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/hide" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Pin a comment

`POST /inbox/comments/{commentId}/pin`

Access: `write` · MCP tool: `pin-comment` · Zernio: `POST /v1/inbox/comments/{postId}/{commentId}/pin`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `account_id` (string)
- `post_id` (string)

```bash
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:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Unpin a comment

`DELETE /inbox/comments/{commentId}/pin`

Access: `write` · MCP tool: `unpin-comment` · Zernio: `DELETE /v1/inbox/comments/{postId}/{commentId}/pin`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Query parameters

- `account_id` (string)
- `like_uri` (string)
- `post_id` (string)

```bash
curl -X DELETE "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/pin" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Like a comment

`POST /inbox/comments/{commentId}/like`

Access: `write` · MCP tool: `like-comment` · Zernio: `POST /v1/inbox/comments/{postId}/{commentId}/like`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `account_id` (string)
- `reaction_type` (string; one of LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT)
- `cid` (string)

```bash
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:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Unlike a comment

`DELETE /inbox/comments/{commentId}/like`

Access: `write` · MCP tool: `unlike-comment` · Zernio: `DELETE /v1/inbox/comments/{postId}/{commentId}/like`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Query parameters

- `account_id` (string)
- `like_uri` (string)
- `post_id` (string)

```bash
curl -X DELETE "https://api.socialit.com/v1/inbox/comments/COMMENT_ID/like" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "comment",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "inbox_post_id": "string",
  "post_id": "string",
  "external_post_id": "string",
  "external_id": "string",
  "parent_id": "string",
  "external_parent_id": "string",
  "is_reply": true,
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string",
    "is_owner": true
  },
  "text": "string",
  "attachments": [
    {
      "type": "string",
      "url": "https://example.com"
    }
  ],
  "like_count": 1,
  "reply_count": 1,
  "is_hidden": true,
  "is_pinned": true,
  "is_liked": true,
  "like_uri": "string",
  "cid": "string",
  "moderation_status": "string",
  "is_edited": true,
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "can_reply": true,
  "can_delete": true,
  "can_hide": true,
  "can_like": true,
  "url": "https://example.com",
  "commented_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `send-private-reply` · Zernio: `POST /v1/inbox/comments/{postId}/{commentId}/private-reply`

### Path parameters

- `commentId` (string; required; 1–500 characters): Comment id (cmt_…) or the network comment id (with account_id)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; required; 1–2000 characters)
- `quick_replies` (array of object; ≤ 13 items)
  - `quick_replies[].title` (string; required; 1–20 characters)
  - `quick_replies[].payload` (string; required; ≤ 1000 characters)
  - `quick_replies[].image_url` (string)
- `buttons` (array of object; ≤ 3 items)
  - `buttons[].type` (string; required; one of url, postback, phone)
  - `buttons[].title` (string; required; 1–20 characters)
  - `buttons[].url` (string)
  - `buttons[].payload` (string)
  - `buttons[].phone` (string)
- `account_id` (string)

```bash
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:

```json
{
  "object": "message",
  "id": "string",
  "conversation_id": "string",
  "account_id": "string",
  "platform": "string",
  "external_id": "string",
  "direction": "inbound",
  "text": "string",
  "sender": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "attachments": [
    {
      "index": 1,
      "type": "string",
      "url": "https://example.com",
      "mime_type": "string",
      "filename": "string",
      "size": 1,
      "preview_url": "https://example.com",
      "media_id": "string",
      "refresh_url": "https://example.com"
    }
  ],
  "status": "string",
  "error": {
    "code": "string",
    "message": "string"
  },
  "reactions": [
    {
      "emoji": "string",
      "from_me": true,
      "sender_id": "string",
      "reacted_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "reply_to_id": "string",
  "reply_to_external_id": "string",
  "is_edited": true,
  "edited_at": "2026-10-13T09:00:00.000Z",
  "edit_count": 1,
  "edit_history": [
    {
      "text": "string",
      "edited_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "is_deleted": true,
  "deleted_at": "2026-10-13T09:00:00.000Z",
  "sent_via": "string",
  "sent_by_user_id": "string",
  "sent_at": "2026-10-13T09:00:00.000Z",
  "delivered_at": "2026-10-13T09:00:00.000Z",
  "read_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## List reviews

`GET /inbox/reviews`

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

Access: `read` · MCP tool: `list-reviews` · Zernio: `GET /v1/inbox/reviews`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of reviewed_at, rating)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string): Only items of this profile (pro_…)
- `account_id` (string): Only items of this account (sa_…)
- `platform` (string; one of facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, …)
- `min_rating` (integer; 1–5)
- `max_rating` (integer; 1–5)
- `has_reply` (boolean)
- `status` (string; one of open, archived)
- `read` (boolean)
- `refresh` (boolean): Fetch the latest reviews from the networks first

```bash
curl "https://api.socialit.com/v1/inbox/reviews" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "review",
      "id": "string",
      "account_id": "string",
      "profile_id": "string",
      "platform": "string",
      "account": {
        "id": "string",
        "platform": "string",
        "username": "string",
        "display_name": "string",
        "avatar_url": "https://example.com",
        "profile_id": "string"
      },
      "external_id": "string",
      "location_id": "string",
      "location_name": "string",
      "reviewer": {
        "id": "string",
        "name": "string",
        "avatar_url": "https://example.com"
      },
      "rating": 1,
      "recommendation": "string",
      "text": "string",
      "photos": [
        {
          "url": "https://example.com"
        }
      ],
      "has_reply": true,
      "reply": {
        "external_id": "string",
        "text": "string",
        "replied_at": "2026-10-13T09:00:00.000Z"
      },
      "status": "open",
      "read": true,
      "assignee_id": "string",
      "labels": [
        "string"
      ],
      "url": "https://example.com",
      "reviewed_at": "2026-10-13T09:00:00.000Z",
      "metadata": {},
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com",
  "summary": {
    "total_reviews": 1,
    "average_rating": 1.5
  }
}
```

## Get a review

`GET /inbox/reviews/{reviewId}`

Access: `read` · MCP tool: `get-review`

### Path parameters

- `reviewId` (string; required; 1–500 characters): Review id (rev_…) or the network review id (with account_id)

### Query parameters

- `account_id` (string)

```bash
curl "https://api.socialit.com/v1/inbox/reviews/REVIEW_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "review",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "location_id": "string",
  "location_name": "string",
  "reviewer": {
    "id": "string",
    "name": "string",
    "avatar_url": "https://example.com"
  },
  "rating": 1,
  "recommendation": "string",
  "text": "string",
  "photos": [
    {
      "url": "https://example.com"
    }
  ],
  "has_reply": true,
  "reply": {
    "external_id": "string",
    "text": "string",
    "replied_at": "2026-10-13T09:00:00.000Z"
  },
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "url": "https://example.com",
  "reviewed_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Triage a review

`PATCH /inbox/reviews/{reviewId}`

Access: `write` · MCP tool: `update-review`

### Path parameters

- `reviewId` (string; required; 1–500 characters): Review id (rev_…) or the network review id (with account_id)

### Body

- `read` (boolean)
- `status` (string; one of open, archived)
- `assignee_id` (string | null)
- `labels` (array of string; ≤ 20 items)

```bash
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:

```json
{
  "object": "review",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "location_id": "string",
  "location_name": "string",
  "reviewer": {
    "id": "string",
    "name": "string",
    "avatar_url": "https://example.com"
  },
  "rating": 1,
  "recommendation": "string",
  "text": "string",
  "photos": [
    {
      "url": "https://example.com"
    }
  ],
  "has_reply": true,
  "reply": {
    "external_id": "string",
    "text": "string",
    "replied_at": "2026-10-13T09:00:00.000Z"
  },
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "url": "https://example.com",
  "reviewed_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Reply to a review

`POST /inbox/reviews/{reviewId}/reply`

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

Access: `write` · MCP tool: `reply-to-review` · Zernio: `POST /v1/inbox/reviews/{reviewId}/reply`

### Path parameters

- `reviewId` (string; required; 1–500 characters): Review id (rev_…) or the network review id (with account_id)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; required; 1–4096 characters)
- `account_id` (string)

```bash
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:

```json
{
  "object": "review",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "location_id": "string",
  "location_name": "string",
  "reviewer": {
    "id": "string",
    "name": "string",
    "avatar_url": "https://example.com"
  },
  "rating": 1,
  "recommendation": "string",
  "text": "string",
  "photos": [
    {
      "url": "https://example.com"
    }
  ],
  "has_reply": true,
  "reply": {
    "external_id": "string",
    "text": "string",
    "replied_at": "2026-10-13T09:00:00.000Z"
  },
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "url": "https://example.com",
  "reviewed_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Delete a review reply

`DELETE /inbox/reviews/{reviewId}/reply`

Access: `write` · MCP tool: `delete-review-reply` · Zernio: `DELETE /v1/inbox/reviews/{reviewId}/reply`

### Path parameters

- `reviewId` (string; required; 1–500 characters): Review id (rev_…) or the network review id (with account_id)

### Query parameters

- `account_id` (string)

```bash
curl -X DELETE "https://api.socialit.com/v1/inbox/reviews/REVIEW_ID/reply" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "review",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "location_id": "string",
  "location_name": "string",
  "reviewer": {
    "id": "string",
    "name": "string",
    "avatar_url": "https://example.com"
  },
  "rating": 1,
  "recommendation": "string",
  "text": "string",
  "photos": [
    {
      "url": "https://example.com"
    }
  ],
  "has_reply": true,
  "reply": {
    "external_id": "string",
    "text": "string",
    "replied_at": "2026-10-13T09:00:00.000Z"
  },
  "status": "open",
  "read": true,
  "assignee_id": "string",
  "labels": [
    "string"
  ],
  "url": "https://example.com",
  "reviewed_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## List mentions

`GET /inbox/mentions`

Access: `read` · MCP tool: `list-mentions` · Zernio: `GET /v1/inbox/mentions`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of mentioned_at)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string): Only items of this profile (pro_…)
- `account_id` (string): Only items of this account (sa_…)
- `platform` (string; one of facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, …)
- `kind` (string; one of post, comment, caption, story, reply, quote, tag)
- `read` (boolean)
- `status` (string; one of open, archived)

```bash
curl "https://api.socialit.com/v1/inbox/mentions" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "mention",
      "id": "string",
      "account_id": "string",
      "profile_id": "string",
      "platform": "string",
      "account": {
        "id": "string",
        "platform": "string",
        "username": "string",
        "display_name": "string",
        "avatar_url": "https://example.com",
        "profile_id": "string"
      },
      "external_id": "string",
      "kind": "string",
      "text": "string",
      "permalink": "string",
      "author": {
        "id": "string",
        "name": "string",
        "username": "string",
        "avatar_url": "https://example.com",
        "verified_type": "string"
      },
      "media_id": "string",
      "comment_id": "string",
      "replied": true,
      "status": "open",
      "read": true,
      "mentioned_at": "2026-10-13T09:00:00.000Z",
      "metadata": {},
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Get a mention

`GET /inbox/mentions/{mentionId}`

Access: `read` · MCP tool: `get-mention`

### Path parameters

- `mentionId` (string; required; 1–80 characters): Mention id (mtn_…)

```bash
curl "https://api.socialit.com/v1/inbox/mentions/mtn_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "mention",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "kind": "string",
  "text": "string",
  "permalink": "string",
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "media_id": "string",
  "comment_id": "string",
  "replied": true,
  "status": "open",
  "read": true,
  "mentioned_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Triage a mention

`PATCH /inbox/mentions/{mentionId}`

Access: `write` · MCP tool: `update-mention`

### Path parameters

- `mentionId` (string; required; 1–80 characters): Mention id (mtn_…)

### Body

- `read` (boolean)
- `status` (string; one of open, archived)

```bash
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:

```json
{
  "object": "mention",
  "id": "string",
  "account_id": "string",
  "profile_id": "string",
  "platform": "string",
  "account": {
    "id": "string",
    "platform": "string",
    "username": "string",
    "display_name": "string",
    "avatar_url": "https://example.com",
    "profile_id": "string"
  },
  "external_id": "string",
  "kind": "string",
  "text": "string",
  "permalink": "string",
  "author": {
    "id": "string",
    "name": "string",
    "username": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "media_id": "string",
  "comment_id": "string",
  "replied": true,
  "status": "open",
  "read": true,
  "mentioned_at": "2026-10-13T09:00:00.000Z",
  "metadata": {},
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `reply-to-mention` · Zernio: `POST /v1/inbox/mentions/reply`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `text` (string; required; 1–2200 characters)
- `mention_id` (string)
- `account_id` (string)
- `media_id` (string)
- `comment_id` (string)

```bash
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:

```json
{
  "object": "mention_reply",
  "id": "string",
  "mention_id": "string",
  "account_id": "string",
  "media_id": "string",
  "comment_id": "string"
}
```

## Inbox counters

`GET /inbox/counts`

Unread / open counters for badges.

Access: `read` · MCP tool: `get-inbox-counts`

### Query parameters

- `profile_id` (string)
- `account_id` (string)

```bash
curl "https://api.socialit.com/v1/inbox/counts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "inbox_counts",
  "conversations": {
    "open": 1,
    "unread": 1,
    "unassigned": 1,
    "requests": 1
  },
  "comments": {
    "unread": 1
  },
  "reviews": {
    "unread": 1,
    "unanswered": 1
  },
  "mentions": {
    "unread": 1
  }
}
```

## 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: `write` · MCP tool: `sync-inbox`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `account_id` (string)
- `kinds` (array of string; unique)

```bash
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:

```json
{
  "object": "inbox_sync",
  "queued": 1,
  "accounts": [
    "string"
  ],
  "kinds": [
    "string"
  ]
}
```

## Get persistent menu

`GET /accounts/{accountId}/messenger-menu`

Read the persistent menu of a Facebook or Instagram account.

Access: `read` · MCP tool: `get-messenger-menu` · Zernio: `GET /v1/accounts/{accountId}/messenger-menu`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "messenger_menu",
  "account_id": "string",
  "persistent_menu": [
    {}
  ]
}
```

## Set persistent menu

`PATCH /accounts/{accountId}/messenger-menu`

Replace the persistent menu of a Facebook or Instagram account.

Access: `write` · MCP tool: `set-messenger-menu` · Zernio: `PUT /v1/accounts/{accountId}/messenger-menu`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Body

- `persistent_menu` (array of object; required; ≥ 1 items)
  - `persistent_menu[].locale` (string)
  - `persistent_menu[].composer_input_disabled` (boolean)
  - `persistent_menu[].call_to_actions` (array of object; required; 1–20 items)
    - `persistent_menu[].call_to_actions[].type` (string; one of postback, web_url, nested)
    - `persistent_menu[].call_to_actions[].title` (string; 1–30 characters)
    - `persistent_menu[].call_to_actions[].payload` (string; ≤ 1000 characters)
    - `persistent_menu[].call_to_actions[].url` (string; ≤ 2000 characters)
    - `persistent_menu[].call_to_actions[].webview_height_ratio` (string)
    - `persistent_menu[].call_to_actions[].call_to_actions` (array of object; ≤ 5 items)

```bash
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:

```json
{
  "object": "messenger_menu",
  "account_id": "string",
  "persistent_menu": [
    {}
  ]
}
```

## Delete persistent menu

`DELETE /accounts/{accountId}/messenger-menu`

Remove the persistent menu from a Facebook or Instagram account.

Access: `write` · MCP tool: `delete-messenger-menu` · Zernio: `DELETE /v1/accounts/{accountId}/messenger-menu`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-menu" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "messenger_menu",
  "id": "string",
  "deleted": true
}
```

## Get Messenger Get Started button

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

Read the Messenger Get Started button of a Facebook account.

Access: `read` · MCP tool: `get-messenger-get-started` · Zernio: `GET /v1/accounts/{accountId}/messenger-get-started`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "messenger_get_started",
  "account_id": "string",
  "payload": "string"
}
```

## Set Messenger Get Started button

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

Replace the Messenger Get Started button of a Facebook account.

Access: `write` · MCP tool: `set-messenger-get-started` · Zernio: `PUT /v1/accounts/{accountId}/messenger-get-started`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Body

- `payload` (string; required; 1–1000 characters)

```bash
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:

```json
{
  "object": "messenger_get_started",
  "account_id": "string",
  "payload": "string"
}
```

## Delete Messenger Get Started button

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

Remove the Messenger Get Started button from a Facebook account.

Access: `write` · MCP tool: `delete-messenger-get-started` · Zernio: `DELETE /v1/accounts/{accountId}/messenger-get-started`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-get-started" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "messenger_get_started",
  "id": "string",
  "deleted": true
}
```

## Get Messenger greeting text

`GET /accounts/{accountId}/messenger-greeting`

Read the Messenger greeting text of a Facebook account.

Access: `read` · MCP tool: `get-messenger-greeting` · Zernio: `GET /v1/accounts/{accountId}/messenger-greeting`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "messenger_greeting",
  "account_id": "string",
  "greeting": [
    {
      "locale": "en",
      "text": "string"
    }
  ]
}
```

## Set Messenger greeting text

`PATCH /accounts/{accountId}/messenger-greeting`

Replace the Messenger greeting text of a Facebook account.

Access: `write` · MCP tool: `set-messenger-greeting` · Zernio: `PUT /v1/accounts/{accountId}/messenger-greeting`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Body

- `greeting` (array of object; required; ≥ 1 items)
  - `greeting[].locale` (string; required; ≥ 1 characters)
  - `greeting[].text` (string; required; 1–160 characters)

```bash
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:

```json
{
  "object": "messenger_greeting",
  "account_id": "string",
  "greeting": [
    {
      "locale": "en",
      "text": "string"
    }
  ]
}
```

## Delete Messenger greeting text

`DELETE /accounts/{accountId}/messenger-greeting`

Remove the Messenger greeting text from a Facebook account.

Access: `write` · MCP tool: `delete-messenger-greeting` · Zernio: `DELETE /v1/accounts/{accountId}/messenger-greeting`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-greeting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "messenger_greeting",
  "id": "string",
  "deleted": true
}
```

## Get Messenger ice breakers

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

Read the Messenger ice breakers of a Facebook account.

Access: `read` · MCP tool: `get-messenger-ice-breakers` · Zernio: `GET /v1/accounts/{accountId}/messenger-ice-breakers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "messenger_ice_breakers",
  "account_id": "string",
  "ice_breakers": [
    {
      "locale": "en",
      "call_to_actions": [
        {
          "question": "string",
          "payload": "string"
        }
      ]
    }
  ]
}
```

## Set Messenger ice breakers

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

Replace the Messenger ice breakers of a Facebook account.

Access: `write` · MCP tool: `set-messenger-ice-breakers` · Zernio: `PUT /v1/accounts/{accountId}/messenger-ice-breakers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Body

- `ice_breakers` (array of object; required; ≥ 1 items)
  - `ice_breakers[].locale` (string; required; ≥ 1 characters)
  - `ice_breakers[].call_to_actions` (array of object; required; 1–4 items)
    - `ice_breakers[].call_to_actions[].question` (string; required; 1–80 characters)
    - `ice_breakers[].call_to_actions[].payload` (string; required; 1–1000 characters)

```bash
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:

```json
{
  "object": "messenger_ice_breakers",
  "account_id": "string",
  "ice_breakers": [
    {
      "locale": "en",
      "call_to_actions": [
        {
          "question": "string",
          "payload": "string"
        }
      ]
    }
  ]
}
```

## Delete Messenger ice breakers

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

Remove the Messenger ice breakers from a Facebook account.

Access: `write` · MCP tool: `delete-messenger-ice-breakers` · Zernio: `DELETE /v1/accounts/{accountId}/messenger-ice-breakers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/messenger-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "messenger_ice_breakers",
  "id": "string",
  "deleted": true
}
```

## Get Instagram ice breakers

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

Read the Instagram ice breakers of a Instagram account.

Access: `read` · MCP tool: `get-instagram-ice-breakers` · Zernio: `GET /v1/accounts/{accountId}/instagram-ice-breakers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "instagram_ice_breakers",
  "account_id": "string",
  "ice_breakers": [
    {
      "question": "string",
      "payload": "string"
    }
  ]
}
```

## Set Instagram ice breakers

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

Replace the Instagram ice breakers of a Instagram account.

Access: `write` · MCP tool: `set-instagram-ice-breakers` · Zernio: `PUT /v1/accounts/{accountId}/instagram-ice-breakers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Body

- `ice_breakers` (array of object; required; 1–4 items)
  - `ice_breakers[].question` (string; required; 1–80 characters)
  - `ice_breakers[].payload` (string; required; 1–1000 characters)

```bash
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:

```json
{
  "object": "instagram_ice_breakers",
  "account_id": "string",
  "ice_breakers": [
    {
      "question": "string",
      "payload": "string"
    }
  ]
}
```

## Delete Instagram ice breakers

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

Remove the Instagram ice breakers from a Instagram account.

Access: `write` · MCP tool: `delete-instagram-ice-breakers` · Zernio: `DELETE /v1/accounts/{accountId}/instagram-ice-breakers`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/instagram-ice-breakers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "instagram_ice_breakers",
  "id": "string",
  "deleted": true
}
```

## Repost (retweet) a post on X

`POST /accounts/{accountId}/x/retweets`

Access: `write` · MCP tool: `retweet` · Zernio: `POST /v1/twitter/retweet`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `tweet_id` (string; required; 1–300 characters)

```bash
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:

```json
{
  "object": "x_retweet",
  "account_id": "string",
  "tweet_id": "string",
  "retweeted": true
}
```

## Undo a repost on X

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

Access: `write` · MCP tool: `unretweet` · Zernio: `DELETE /v1/twitter/retweet`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)
- `tweetId` (string; required; 1–300 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/retweets/TWEET_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "x_retweet",
  "account_id": "string",
  "tweet_id": "string",
  "retweeted": true
}
```

## Bookmark a post on X

`POST /accounts/{accountId}/x/bookmarks`

Access: `write` · MCP tool: `bookmark-tweet` · Zernio: `POST /v1/twitter/bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `tweet_id` (string; required; 1–300 characters)

```bash
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:

```json
{
  "object": "x_bookmark",
  "account_id": "string",
  "tweet_id": "string",
  "bookmarked": true
}
```

## Remove an X bookmark

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

Access: `write` · MCP tool: `remove-bookmark` · Zernio: `DELETE /v1/twitter/bookmark`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)
- `tweetId` (string; required; 1–300 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/bookmarks/TWEET_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "x_bookmark",
  "account_id": "string",
  "tweet_id": "string",
  "bookmarked": true
}
```

## 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: `write` · MCP tool: `follow-x-user` · Zernio: `POST /v1/twitter/follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `target_user_id` (string; required; 1–64 characters)

```bash
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:

```json
{
  "object": "x_follow",
  "account_id": "string",
  "target_user_id": "string",
  "following": true,
  "pending_follow": true
}
```

## Unfollow a user on X

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

Access: `write` · MCP tool: `unfollow-x-user` · Zernio: `DELETE /v1/twitter/follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)
- `targetUserId` (string; required; 1–64 characters)

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/following/TARGET_USER_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "x_follow",
  "account_id": "string",
  "target_user_id": "string",
  "following": true,
  "pending_follow": true
}
```

## 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: `read` · MCP tool: `search-tweets` · Zernio: `GET /v1/twitter/search`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Query parameters

- `query` (string; required; 1–512 characters)
- `limit` (integer; 10–100)
- `since_id` (string; pattern ^[0-9]+$)
- `until_id` (string; pattern ^[0-9]+$)
- `start_time` (string (date-time))
- `end_time` (string (date-time))
- `cursor` (string)
- `sort_order` (string; one of recency, relevancy)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/search?query=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "tweet",
      "id": "string",
      "text": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "conversation_id": "string",
      "in_reply_to_tweet_id": "string",
      "lang": "string",
      "author": {
        "id": "string",
        "username": "string",
        "name": "string",
        "avatar_url": "https://example.com",
        "verified_type": "string"
      },
      "like_count": 1,
      "reply_count": 1,
      "retweet_count": 1,
      "quote_count": 1,
      "url": "https://example.com"
    }
  ],
  "limit": 1,
  "has_more": true,
  "next_cursor": "string",
  "previous_cursor": "string",
  "meta": {
    "result_count": 1,
    "newest_id": "string",
    "oldest_id": "string"
  }
}
```

## Look up a post on X

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

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

Access: `read` · MCP tool: `get-tweet` · Zernio: `GET /v1/twitter/tweet`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)
- `tweetId` (string; required; 1–300 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/x/tweets/TWEET_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "tweet",
  "id": "string",
  "text": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "conversation_id": "string",
  "in_reply_to_tweet_id": "string",
  "lang": "string",
  "author": {
    "id": "string",
    "username": "string",
    "name": "string",
    "avatar_url": "https://example.com",
    "verified_type": "string"
  },
  "like_count": 1,
  "reply_count": 1,
  "retweet_count": 1,
  "quote_count": 1,
  "url": "https://example.com"
}
```

## Search Reddit posts

`GET /accounts/{accountId}/reddit/search`

Access: `read` · MCP tool: `search-reddit` · Zernio: `GET /v1/reddit/search`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Query parameters

- `q` (string; required; 1–512 characters)
- `subreddit` (string; ≤ 100 characters)
- `restrict_sr` (boolean)
- `sort` (string; one of relevance, hot, top, new, comments)
- `t` (string; one of hour, day, week, month, year, all)
- `limit` (integer; 1–100)
- `after` (string)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/search?q=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "reddit_post",
      "id": "string",
      "fullname": "string",
      "title": "string",
      "author": "string",
      "subreddit": "string",
      "url": "https://example.com",
      "permalink": "string",
      "selftext": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "num_comments": 1,
      "over_18": true,
      "stickied": true,
      "flair_text": "string",
      "is_gallery": true,
      "gallery_images": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "has_more": true,
  "next_cursor": "string",
  "previous_cursor": "string"
}
```

## Get a subreddit feed

`GET /accounts/{accountId}/reddit/feed`

Access: `read` · MCP tool: `get-reddit-feed` · Zernio: `GET /v1/reddit/feed`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)

### Query parameters

- `subreddit` (string; ≤ 100 characters)
- `sort` (string; one of hot, new, top, rising)
- `t` (string; one of hour, day, week, month, year, all)
- `limit` (integer; 1–100)
- `after` (string)
- `cursor` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/feed" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "reddit_post",
      "id": "string",
      "fullname": "string",
      "title": "string",
      "author": "string",
      "subreddit": "string",
      "url": "https://example.com",
      "permalink": "string",
      "selftext": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "num_comments": 1,
      "over_18": true,
      "stickied": true,
      "flair_text": "string",
      "is_gallery": true,
      "gallery_images": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "has_more": true,
  "next_cursor": "string",
  "previous_cursor": "string"
}
```

## Get a Reddit post's comments

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

Access: `read` · MCP tool: `get-reddit-post-comments` · Zernio: `GET /v1/reddit/comments/{postId}`

### Path parameters

- `accountId` (string; required; 1–80 characters): Account id (sa_…)
- `postId` (string; required; 1–64 characters)

### Query parameters

- `sort` (string; one of new, top, best, controversial, old, qa)
- `limit` (integer; 1–500)
- `comment_id` (string; ≤ 64 characters)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/reddit/posts/POST_ID/comments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "reddit_comment_thread",
  "post": {
    "object": "reddit_post",
    "id": "string",
    "fullname": "string",
    "title": "string",
    "author": "string",
    "subreddit": "string",
    "url": "https://example.com",
    "permalink": "string",
    "selftext": "string",
    "created_at": "2026-10-13T09:00:00.000Z",
    "score": 1,
    "num_comments": 1,
    "over_18": true,
    "stickied": true,
    "flair_text": "string",
    "is_gallery": true,
    "gallery_images": [
      "string"
    ]
  },
  "data": [
    {
      "object": "reddit_comment",
      "id": "string",
      "fullname": "string",
      "parent_id": "string",
      "author": "string",
      "body": "string",
      "permalink": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "score": 1,
      "num_replies": 1,
      "depth": 1,
      "is_submitter": true,
      "edited": true,
      "stickied": true,
      "distinguished": "string"
    }
  ],
  "more": [
    "string"
  ]
}
```


---

Source: https://socialit.com/docs/api-reference/inbox/
