Concept
Objects and IDs
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:
{
"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.