Skip to content
Docs

Concept

How Socialit objects, IDs, dates and the workspace hierarchy fit together.

Updated Oct 13, 2026

The hierarchy

  • A workspace holds members, billing, API keys and webhooks.
  • Profiles group accounts by brand or client. Members and API keys can be limited to some profiles.
  • Accounts are connected identities on a network.
  • Posts target one or more accounts; each target is a posting with its own status, network ID and URL.
  • Conversations, messages, comments and reviews make up the inbox; senders become contacts.

IDs

Every object has an ID made of a prefix and 27 base62 characters, such as pst_2LwQ9xKfT1mB7cRzV3nYp8aHsJd. The prefix tells you the type:

Prefix Object
ws_ Workspace
pro_ Profile
sa_ Account
pst_ Post
sp_ Posting
med_ Media
que_ Queue
conv_ Conversation
msg_ Message
cmt_ Comment
rev_ Review
con_ Contact
wh_ Webhook
key_ API key

References to other objects use <thing>_id and hold the ID, for example profile_id.

Object shape

Objects are flat JSON with snake_case fields, an object type and timestamps:

JSON
{
  "object": "account",
  "id": "sa_7Yt2pQ9xLmB4cRzV1nYt8aHsJw",
  "platform": "youtube",
  "name": "Northwind Studio",
  "status": "active",
  "created_at": "2026-10-01T08:12:44.381Z",
  "updated_at": "2026-10-13T16:42:07.118Z"
}

Dates are ISO 8601 in UTC with milliseconds. Platform keys are facebook, instagram, x, linkedin, threads, bluesky, pinterest, tiktok, youtube, google_business, reddit, snapchat, discord and mastodon. The API also accepts twitter for x and googlebusiness for google_business.