Skip to content

Social

Posts from your own accounts on LinkedIn, X, Reddit, YouTube, TikTok and Instagram, published or scheduled by one call per site.

System
Social
Nouns
2
Verbs
6
Events
5
Post.publish
You, to your agent

Publish my post about the renewal-notice checklist from my LinkedIn.

curl -X POST "https://api.sb/leaseline.app/posts/publish?mode=try" \
  -H "Authorization: Bearer $SB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"post":"post_Lk4vR8sQ2m"}'
npx startup-builder do Post.publish --try --data '{"post":"post_Lk4vR8sQ2m"}'
{
  "name": "do",
  "arguments": {
    "mode": "try",
    "code": "return await $.Post.publish({ post: 'post_Lk4vR8sQ2m' })"
  }
}
import { $ } from 'startup-builder'

const result = await $.try.Post.publish({ post: 'post_Lk4vR8sQ2m' })
Response
{
  "api": "https://api.sb/leaseline.app",
  "post": {
    "$id": "https://api.sb/leaseline.app/posts/post_Lk4vR8sQ2m",
    "$type": "Post",
    "handle": "https://api.sb/leaseline.app/handles/handle_Li9fB3wE6y",
    "format": "text",
    "status": "published",
    "claims": [
      {
        "says": "Leaseline sends every renewal notice 60 days out, per owner.",
        "record": "https://api.sb/leaseline.app/offers/offer_Ls1mP4qR8v"
      }
    ],
    "outside": null,
    "reach": null
  },
  "action": {
    "operation": "Post.publish",
    "mode": "try",
    "status": "done"
  }
}
Try mode reads, stores nothing and spends nothingAPI referenceIts Nouns

Nouns

NounWhat it is
accountAn account is an account or name a startup or Brand holds on an outside platform, bound to an Integration credential.
PostA Post is something an account publishes, such as a thread or a short video, with the reach and replies it earns.

Properties

The hub defines each Noun’s core Properties; Social adds the ones a sale needs.

Handle

PropertyTypeWhat it holdsDefined by
venuestringThe venue it lives on, by id.The hub
namestringThe name as the platform shows it, such as @example.The hub
sharedbooleanTrue for a Studio account shared across sibling startups; every Post names the startup it speaks for.The hub
agentbooleanTrue when an Agent runs it; its bio says so.The hub
integrationintegrationThe Integration credential it publishes through.The hub
followersintegerAs the site reports it, read daily.Social
cadencestringHow often it posts, such as three a week on LinkedIn.Social

Post

PropertyTypeWhat it holdsDefined by
formatstringThe venue’s format, such as shortVideo or thread.The hub
publishAtdatetimeWhen it goes out.The hub
statusstringWhere it stands; a withdrawn Post is kept with its reach and replies.The hub
claimsjsonThe facts it states, each resolving to a record.The hub
reachintegerHow many people saw it, as the venue reports.The hub
handleHandleThe account it goes out from, which picks its site and format.Social
repliesintegerComments and replies, each one a chance to answer as you.Social
engagersProspect[]The people who reacted or commented, read by Prospect.find with kind: engager.Social

Lifecycle

Every move names the Verb that makes it, or the Event it waits on.

Post

StateWhat it meansMoves to
draft (first)Written and not on its account’s calendar.scheduled by Post.schedule; published by Post.publish
scheduledOn its account’s calendar for publishAt.published by Post.publish
publishedLive on its venue, earning reach and replies.withdrawn by Post.withdraw
withdrawnTaken down from its venue, with its record, reach and replies kept.None: it ends here.

Verbs

VerbWhat it doesApprovalOn each site
Post.publishPuts a Post live from your own account on one site, once every claim it makes reads from a live record.Goes out on its ownFacebook, Google Business Profile, Hacker News, Instagram, LinkedIn, Reddit, TikTok, X, YouTube
Post.schedulePuts a drafted Post on your account’s calendar for a set minute, such as 12:01 a.m. Pacific on launch day.Runs on its ownFacebook, Instagram, Product Hunt, TikTok, YouTube
Post.withdrawTakes a published Post down from its site and keeps its record, reach and replies.Runs on its ownX, YouTube
Handle.connectTies your account on a site, such as your LinkedIn or X handle, to the Integration it posts through.Runs on its ownNone.
Post.createSaves a Post as a draft for one account, with its format and the claims it makes.Runs on its ownNone.
Post.updateChanges a draft or scheduled Post before it goes out.Runs on its ownNone.

Events

EventEmitted by
Post.publishedPost.publish
Post.scheduledPost.schedule
Post.withdrawnPost.withdraw
Handle.connectedHandle.connect
Post.createdPost.create

A Trigger can start a Workflow on any of them, and a Watch delivers each to your endpoint, signed (Events and webhooks).

Who operates it

PartSocial
AccountableContent lead
Also calls its VerbsMarketing lead, Founder, Partner Manager
SeatAn agent holds each seat until you seat a person in it.
Asks you firstNone of its Verbs: each runs within its seat’s Limits

Integrations

LinkedIn · X account · Reddit · Hacker News · Product Hunt · YouTube · TikTok · Instagram · Facebook

Import and export

DirectionWhatHow
ImportYour accounts and their past postsHandle.connect per account; past posts come in as published Posts with their reach
ExportEvery Post, its reach and repliesCollection.export

Example

One idea, posted where its buyers read.

  1. Content.draft writes a LinkedIn post from a reply that said “renewals keep slipping”.
  2. Post.schedule puts it on Dana’s LinkedIn for Tuesday at 8:30 Central.
  3. It goes out by Post.publish once its one claim, 64 units tracked in Leaseline, reads from a live record.
  4. Eleven people comment. Prospect.find with kind: engager lists them for the next first touch.

Contents