MB SuiteMB Suite
Menu

API reference · Inbox

Threads

social_inbox · threads · 2 operations

GET/v1/social-inbox/threadsGET/v1/social-inbox/threads/{thread_id}
GET/v1/social-inbox/threads

List Social Inbox threads

social_inbox.threads.list

ReadIdempotentSince 2026-11-01

Lists the inbox threads (one person in one post or in one private conversation), most recent activity first, with cursor pagination: author, last message preview and time, message and unread counts, state and, when someone owns it, assigned_to_user_id and assigned_to_user_name. Filter by state (also pending_reply: unread, read or needs_attention), or by assigned_to (a user id, ai-<position_id> or me). Threads where every message is the brand's own (its sends in a private conversation, its comments) are not people's conversations and are left out unless include_self_authored. What does not run in the database is applied reading on until the page is full (up to 400 threads read per call), so a page brings fewer than limit only with has_more true at that limit. To read the messages, use social_inbox.threads.get. Requires view access to the Social Inbox. With LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).

Scope
social_inbox:read
Permission
View the module
MCP tool
social_inbox_threads_listOn the full surface; on the compact one, mb_execute_operation with id: "social_inbox.threads.list".

Declared cost: up to 401 reads and 0 writes per call (they count against the daily quota).

Parameters

limitintegerqueryoptional

How many items this page brings at most (see the maximum and the default in the schema).

Default: 50

cursorstringqueryoptional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

stateenumqueryoptional

Only threads in this state (unread, read, replied, archived, needs_attention, snoozed, spam, resolved) or pending_reply (unread, read or needs_attention: still waiting for an answer). Absent = any.

Values: unread, read, replied, archived, needs_attention, snoozed, spam, resolved, pending_reply

assigned_tostringqueryoptional

Only threads owned by this person: a member's user id, ai-<position_id> for an AI Community Manager (social_inbox.positions.list), or me (whoever calls).

include_self_authoredbooleanqueryoptional

Also list threads where every message is the brand's own (its sends in a private conversation, its comments). Default false: only people's threads.

Default: false

Response

dataarray<object>
has_moreboolean
next_cursorstring

Errors

invalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Example

curl "https://api.mb-suite.com/v1/social-inbox/threads" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/social-inbox/threads" \
  -H "Authorization: Bearer $MB_TEST_KEY"
GET/v1/social-inbox/threads/{thread_id}

Get a Social Inbox thread with its messages

social_inbox.threads.get

ReadIdempotentSince 2026-11-01

Returns one inbox thread and its messages from that person, oldest first (up to limit, default 100, max 200). The brand's replies live in social_inbox.items.conversation, which also brings both sides. 404 inbox_thread_not_found if it is not in this organization. Requires view access. With LinkedIn or TikTok, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted (the permissions guide lists what each platform allows).

Scope
social_inbox:read
Permission
View the module
MCP tool
social_inbox_threads_getOn the full surface; on the compact one, mb_execute_operation with id: "social_inbox.threads.get".

Declared cost: up to 201 reads and 0 writes per call (they count against the daily quota).

Parameters

thread_idstringpathrequired

The thread id (from social_inbox.threads.list, or thread_id of an item).

limitintegerqueryoptional

How many of its messages at most, oldest first (1 to 200, default 100).

Default: 100

Response

threadobject
itemsarray<object>

Errors

inbox_thread_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Example

curl "https://api.mb-suite.com/v1/social-inbox/threads/{thread_id}" \
  -H "Authorization: Bearer $MB_API_KEY"

Try it with your test API key

With a test API key the request always goes to your practice organization: example data you can reset.

curl "https://api.mb-suite.com/v1/social-inbox/threads/{thread_id}" \
  -H "Authorization: Bearer $MB_TEST_KEY"