# Objects and IDs

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

## 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`.

---

Source: https://socialit.com/docs/concepts/objects/
