Skip to content
SociaMesh

Connect accounts

Send your user through the platform's own consent screen.

GET /v1/connect/{platform}?profileId=prof_…&returnUrl=https://app.example.com/connected

The 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 profileId to put the new account there.
  • Bluesky takes handle to 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.