Headless connect

The flow

All three API calls need the accounts:connect scope, and all must use the same API key — a connect token works only with the key that started it.

Step by step

1. Start the connection

   Call POST/connect/{platform}/headless with the URL your user should come back to (https://, or http://localhost while developing). For Mastodon-family networks, pass the user's server as instance. Pass the ecosystemId the account belongs to — required on Pro, where every account lives in an ecosystem; on Unlimited you may leave it out to connect many accounts at once.

   RequestCopy

   curl -X POST "https://dashboard.lifebliss.app/api/v1/connect/facebook/headless" \
     -H "Authorization: Bearer $PS_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{ "redirectUrl": "https://app.example.org/connected" }'
   
   # 201 → { "authUrl": "https://www.facebook.com/…", "state": "…", "expiresInSeconds": 900 }

2. Send your user to authUrl

   Redirect the user to authUrl within 15 minutes. They sign in to the network and approve access there.

3. Receive the connect token

   The user lands back on your redirectUrl with a connect_token — or an error if they cancelled or the network refused. The token is valid for 15 minutes.

   RedirectCopy

   https://app.example.org/connected
     ?connect_token=…
     &platform=facebook
     &step=select_account

4. Show what they can publish to

   One login can manage many pages or channels. GET/connect/select lists them, paginated, with an optional search; matchedIds holds every match across pages so a “select all” is one call. Render the choices in your own UI.

   RequestCopy

   curl "https://dashboard.lifebliss.app/api/v1/connect/select?token=$CONNECT_TOKEN&search=evening" \
     -H "Authorization: Bearer $PS_API_KEY"

   Response · 200Copy

   {
     "platform": "facebook",
     "total": 14,
     "matched": 2,
     "page": 1,
     "hasMore": false,
     "accounts": [
       { "platformAccountId": "1029…", "displayName": "Evening Sessions", "username": null, "avatarUrl": "…" }
     ],
     "matchedIds": ["1029…", "4471…"]
   }

5. Finish

   Send the chosen platformAccountIds (or one platformAccountId) toPOST/connect/select. Put them in an existing group with groupId, or a new one with newGroupName. The accounts are now ready to publish to.

   RequestCopy

   curl -X POST "https://dashboard.lifebliss.app/api/v1/connect/select" \
     -H "Authorization: Bearer $PS_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "token": "CONNECT_TOKEN",
       "platformAccountIds": ["1029…", "4471…"],
       "newGroupName": "Evening pages"
     }'
   
   # 201 → { "connected": 2, "accounts": [ … ], "group": { … }, "unavailable": [], "warnings": [] }

Rules and errors