List Social Inbox threads
social_inbox.threads.list
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).
- Escopo
social_inbox:read- Permissão
- Ver o módulo
- Tool do MCP
social_inbox_threads_listNa superfície completa; na compacta,mb_execute_operationcomid: "social_inbox.threads.list".
Custo declarado: até 401 leituras e 0 escritas por chamada (contam na cota diária).
Parâmetros
limitintegerqueryopcionalHow many items this page brings at most (see the maximum and the default in the schema).
Padrão: 50
cursorstringqueryopcionalThe next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
stateenumqueryopcionalOnly 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.
Valores: unread, read, replied, archived, needs_attention, snoozed, spam, resolved, pending_reply
assigned_tostringqueryopcionalOnly 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_authoredbooleanqueryopcionalAlso list threads where every message is the brand's own (its sends in a private conversation, its comments). Default false: only people's threads.
Padrão: false
Resposta
dataarray<object>has_morebooleannext_cursorstringErros
Exemplo
curl "https://api.mb-suite.com/v1/social-inbox/threads" \
-H "Authorization: Bearer $MB_API_KEY"Testar com a sua API key de teste
Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.
curl "https://api.mb-suite.com/v1/social-inbox/threads" \
-H "Authorization: Bearer $MB_TEST_KEY"