Sola MerlinoDocumentation
How it works

Account Model

Sola Merlino organizes every syndication identity into four nested layers — from the brand that owns the content down to the warmed Gmail account that publishes it.

Account-management model
The four-layer account model: a BrandWorkspace owns SyndicationPersonas, each bound to a warmed GmailAccount, with Warming campaigns driving each identity from created to active.

The account model is the backbone of safe, at-scale syndication. A brand's content does not post from one account — it posts from a fleet of distinct, individually warmed identities, each with its own stable fingerprint, assigned proxy region, and human cadence. The model below describes how those identities are grouped, provisioned, and aged so that legitimate business content reaches every platform without tripping fraud detection.

The four layers

Each layer owns the one below it. A workspace defines the brand and its platform set; personas are the individual avatars inside that workspace; every persona is backed by a real Gmail account; and warming is the lifecycle process that brings each account from cold to publish-ready.

BW

BrandWorkspace

The top-level container for a brand. Defines the subscription tier (avatar capacity) and the list of platforms the brand syndicates to. All personas, content, and warming activity live inside a workspace.

/api/brand-workspaces
SP

SyndicationPersona

An individual avatar within a workspace. Carries its own fingerprintId, proxyRegion, agingStage (0–7), status, and avatarRole. This is the identity that actually publishes.

/api/personas
GA

GmailAccount

The real, active Gmail account backing a persona. Stores email, password, cookies, and a profilePath for the browser identity. 121 real accounts are preloaded, all active.

/api/gmail/accounts
WC

Warming

The aging lifecycle attached to an account: a WarmingCampaign drives a sequence of WarmingActivity records on a WarmingSchedule. See warming for the full 30-day program.

/api/warmup/stats
LayerOwnsKey fieldsLifecycle
BrandWorkspacePersonas, content, platformstier, platforms[]per subscription tier
SyndicationPersonaOne Gmail accountfingerprintId, proxyRegion, agingStage 0–7, status, avatarRolecreated → warming → ready → active
GmailAccountBrowser profileemail, password, cookies, profilePathimported → warmed
WarmingActivities & scheduleWarmingCampaign, WarmingActivity, WarmingSchedule30-day, 5 phases
Why the layering matters

Account safety is IP and network hygiene, not content manipulation. Because each persona carries its own stable fingerprint and assigned proxy region and only acts on a human cadence, a brand can publish its own content across a large fleet without any single identity looking automated. The layers keep those identities cleanly separated.

Workspace tiers

A BrandWorkspace's tier sets how many avatars (personas) it can hold. Pick the tier that matches the brand's syndication footprint; the platform list is configured independently on the workspace.

TierAvatars
starter5
growth15
scale35
agency75

Persona lifecycle

Every SyndicationPersona moves through a fixed status lifecycle as it is provisioned and aged. A persona is only allowed to publish once it has earned its way to active.

created warming ready active
  • created — the persona exists and is bound to a Gmail account, fingerprint, and proxy region, but has not yet begun aging.
  • warming — a WarmingCampaign is running; the account is building history through scheduled human-cadence activity.
  • ready — warming is complete and the identity has cleared its health checks, but it is not yet assigned to live syndication.
  • active — the persona is in the syndication rotation and publishing the brand's content.

The agingStage field

Alongside status, each persona tracks an agingStage from 0 to 7. This is the maturity dial that gates how the identity may be used: an identity only takes on syndication work when its aging stage allows it, mirroring the phased warming program. Lower stages are freshly created or early-warming identities held back from real posting; higher stages are seasoned identities cleared for full per-platform publishing on a human cadence. The aging stage advances as the warming campaign progresses through its phases.

Stage gates the work

Runners (cascade-runner, syndication-runner) only allocate a publishing task to a persona when its aging stage permits. A cold or early-stage identity is never asked to post at the cadence of a mature one — that staging is what keeps the fleet account-safe.

The Care Mountain example

Sola Merlino ships with one fully provisioned reference workspace so you can see the model end to end without building anything first.

Care Mountain

The preloaded reference BrandWorkspace, configured at the scale tier (35-avatar capacity). It demonstrates the complete account model with real, active identities ready to inspect.

35
scale tier capacity
16
personas
4
platforms
621
DAM assets

Its four platforms are youtube twitter facebook linkedin, and its 16 personas draw from a pool of 121 preloaded Gmail accounts. Use Care Mountain to walk a brand's own content from the DAM through Universal Writer and out to social via warmed identities.

For how each persona is aged before it joins the rotation, see warming.

Sola Merlino · social syndication + account automation · documentation generated 2026-06-27