Connect accounts
Send your user through the platform's own consent screen.
GET /v1/connect/{platform}?profileId=prof_…&returnUrl=https://app.example.com/connectedThe answer is { url, expiresAt }. Send the user's browser to url: they see which project is
asking, approve on the platform itself, and land back on returnUrl (it must start with one of the
project's allowed return URLs, set in the console) or on SociaMesh's result page.
- Profiles group accounts (one per customer of yours, say). Pass
profileIdto put the new account there. - Bluesky takes
handleto skip typing it on the consent page. - Pages, organizations and channels: platforms that manage several (Facebook Pages, LinkedIn organizations, YouTube channels, Google Business locations) create one account each.
GET /v1/accounts lists them. An account whose access ended shows reauthorization_required; it
can't publish until the user connects it again, and you get an
account.reauthorization_required webhook when that happens.
Your own platform apps
By default accounts connect through SociaMesh's shared app on each platform. To show your own
brand on consent screens, add your app's credentials under OAuth apps in the console (or
POST /v1/apps); connections then go through it.