Menu

API reference · Inbox

Connected accounts

social_inbox · connections · 1 operation

GET/v1/social-inbox/connections

List the accounts connected to the Social Inbox

social_inbox.connections.list

ReadIdempotentSince 2026-11-01

Lists the social accounts the inbox can read and answer: platform, account_id (the source_account_id of its items), account_name, avatar and has_credential (false means the account is linked but its credential is missing or expired: reconnect it from Integrations). For TikTok, messaging_capable false means direct messages are not available for that account (messaging_unavailable_reason says why). Connecting accounts is done in the app. 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_connections_listOn the full surface; on the compact one, mb_execute_operation with id: "social_inbox.connections.list".

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

Parameters

No parameters.

Response

dataarray<object>

Errors

Example

curl "https://api.mb-suite.com/v1/social-inbox/connections" \
  -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/connections" \
  -H "Authorization: Bearer $MB_TEST_KEY"