# Start an OAuth connect session with the PostEverywhere API

**Source:** https://posteverywhere.ai/docs/api/start-social-connect

---

[🤖Connect ChatGPT, Claude or any AI agent to manage your social media end to endConnect your AI agent to manage your social media](https://posteverywhere.ai/agents)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](https://posteverywhere.ai/docs/authentication) · [API key scopes](https://posteverywhere.ai/docs/scopes)

Copy MarkdownCopy for LLMThis endpoint accepts a JSON request body. See the [auth guide](https://posteverywhere.ai/docs/authentication) for a worked example.

## Responses

- 200Session started
- 400
- 401
- 402
- 403
- 404
- 429
- 500

## More in Auth

- [Start device login](https://posteverywhere.ai/docs/api/start-device-auth)
- [Poll a device login](https://posteverywhere.ai/docs/api/poll-device-token)
- [Poll OAuth session](https://posteverywhere.ai/docs/api/poll-social-connect)
- [Connect Bluesky](https://posteverywhere.ai/docs/api/connect-bluesky)
- [Connect Telegram](https://posteverywhere.ai/docs/api/connect-telegram)
- [Connect Discord](https://posteverywhere.ai/docs/api/connect-discord)
[← Poll a device login](https://posteverywhere.ai/docs/api/poll-device-token)[Poll OAuth session →](https://posteverywhere.ai/docs/api/poll-social-connect)[← All endpoints](https://posteverywhere.ai/docs/api/reference)