POST/auth/social-connect/start
Start an OAuth connect session with the PostEverywhere API
Requires an API key (session fallback rejected with `401 api_key_required`). For the browser-OAuth platforms (instagram, facebook, threads, x, linkedin, tiktok, youtube, pinterest) this returns the dashboard's OAuth-start `authorize_url` to open in a logged-in browser, plus a `session_id` to poll. Headless platforms (bluesky, telegram, discord) are rejected with `400 use_headless_endpoint` — POST credentials to their dedicated endpoints instead. `mode: reconnect` requires `account_id`.
Guides: Authentication guide · API key scopes
This endpoint accepts a JSON request body. See the auth guide for a worked example.
Responses
- 200Session started
- 400
- 401
- 402
- 403
- 404
- 429
- 500