Skip to content
Docs

Guide

Everything a network's API allows for one connected account, through a manifest, generic operations and typed per-network endpoints, with scope upgrades on demand.

Updated Oct 14, 2026

Publishing and the inbox cover what every network has in common. Focus mode covers the rest: everything a network’s API allows for one connected account, such as YouTube playlists, captions and live broadcasts, Reddit mod queues, Discord roles or Mastodon filters. The app renders it as a full-screen workspace per account (see UI modes); the API exposes the same resources in two shapes.

Shape Reference MCP toolset Use it for
Generic operations Focus (10 endpoints) focus Building a UI from the manifest, one integration for every network
Typed operations Focus · YouTube, Focus · X, … (one tag per network) focus_youtube, focus_x, … Documented, typed calls and SDKs; agents working on one network

Both run through the same dispatcher, return the same shapes and need the same scopes.

1. Read the manifest

Terminal
curl https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/focus \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"

The manifest lists the account’s resources (videos, live-broadcasts, playlists, …). Each one has JSON-schema fields, the operations it supports (list, get, create, update, delete) with their query and body schemas, named actions (go-live, set-thumbnail, …), whether it is a singleton, and its typed_path. GET /v1/focus/platforms lists the networks with a focus module and their toolsets.

2. Call a resource

Generic routes take the resource key and action name from the manifest:

Operation Generic Typed (YouTube example)
List GET /v1/accounts/{accountId}/focus/{resource} GET /v1/accounts/{accountId}/youtube/videos
Get GET …/focus/{resource}/{itemId} GET …/youtube/videos/{itemId}
Create POST …/focus/{resource} POST …/youtube/playlists
Update PATCH …/focus/{resource}/{itemId} PATCH …/youtube/videos/{itemId}
Delete DELETE …/focus/{resource}/{itemId} DELETE …/youtube/playlists/{itemId}
Item action POST …/focus/{resource}/{itemId}/{action} POST …/youtube/live-broadcasts/{itemId}/go-live
Collection action POST …/focus/{resource}/-/{action} POST …/youtube/videos/{action}

Singleton resources (a channel’s settings, a Discord server’s welcome screen) have no item ID: GET, PATCH and DELETE the resource path itself.

  • Query parameters and bodies are validated against the resource’s schemas (422 validation_failed with errors per field). Fields with format: "media-id" take Socialit media IDs (med_…).
  • Lists use cursors: pass next_cursor back as cursor.
  • Items are returned as the network object, in snake_case, never stripped of extra fields.
  • Typed operation IDs and MCP tools follow <network>-<resource>-<operation>, such as youtube-videos-list or youtube-live-broadcasts-go-live.

3. Upgrade scopes when you need them

Accounts connect with the core scopes for publishing, inbox and analytics. Focus resources often need more. The manifest tells you:

  • resources[].available is false when the account lacks the resource’s scopes, and resources[].missing_scopes lists them.
  • The top-level missing_scopes is the union, and reconnect_url is a ready-made link: GET /v1/connect/youtube?reconnect_account_id=sa_…&scope_set=focus.
  • Calling a resource without its scopes answers 403 missing_scopes with missing_scopes and reconnect_url.

Send the user through reconnect_url (it keeps the account, its profile and history, and never counts against your allowance). New connections can ask for everything up front with scope_set=focus on GET /v1/connect/{platform}.

MCP

The generic tools are in toolset focus; each network’s typed tools are in focus_<network>. There are nearly 2,000 typed tools, so select the networks you need:

Text
https://api.socialit.com/mcp?toolsets=focus,focus_youtube

See MCP server.