---
title: "List social inbox conversations (newest activity first)"
method: GET
path: "/inbox/conversations"
tags: ["Inbox"]
---

# List social inbox conversations (newest activity first)

`GET /inbox/conversations`

Returns one entry per conversation (the latest message in each), across Instagram and Facebook DMs, comments, and mentions, LinkedIn company-page comments and mentions (LinkedIn has no DMs via API), TikTok video comments (comments only; requires the TikTok comments authorization on the channel), YouTube video comments (comments only; each channel is checked once per day, YouTube has no comment webhooks), X DMs for workspaces that opted in to X DMs in the dashboard (X is DM-only; no history from before opt-in), and Threads replies on your posts plus mentions (requires a Threads connection with the reply-reading permission; currently rolling out). Cursor-paginated: follow `pagination.next_cursor` until it is null. Requires the `inbox:read` scope (API keys) or the `access_social_inbox` permission (OAuth/MCP).

## Query parameters

- `limit` integer
- `cursor` string
- `platform` 'instagram' | 'facebook' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'threads'
- `type` 'dm' | 'comment' | 'mention'
- `unread` boolean

## Response `200`

A page of conversations

- object
  - `data` InboxConversation[]
    - `conversation_id` string
    - `platform` 'instagram' | 'facebook' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'threads'
    - `type` 'dm' | 'comment' | 'mention' — dm = direct message; comment/mention = public interaction. LinkedIn is comment/mention only; TikTok and YouTube are comment only; X is dm only; Threads is comment (replies on your posts) and mention only.
    - `participant` InboxParticipant
      - `id` string — Platform-scoped id of the other party
      - `name` string
      - `username` string
      - `profile_picture` string, nullable
    - `unread_count` integer — Unread incoming messages in this conversation
    - `last_message` object
      - `id` string
      - `direction` 'incoming' | 'outgoing'
      - `text` string
      - `timestamp` string, date-time
      - `is_read` boolean
    - `post` object, nullable — Present for comment/mention conversations
      - `id` string, nullable
      - `caption` string, nullable
      - `thumbnail` string, nullable
  - `pagination` InboxCursorPagination
    - `next_cursor` string, nullable — Pass as ?cursor= to fetch the next page; null when there are no more results
    - `has_more` boolean
    - `limit` integer

---

[API](https://skmtc.dev/omnisocials/apis/omnisocials-api.md) · [All operations](https://skmtc.dev/omnisocials/apis/omnisocials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisocials/omnisocials-api/revisions/e53b89af0b98/schema)