Connect

Endpoint

GET https://api.postpeer.dev/v1/connect/{platform}

Path Parameters

Query Parameters

Example

curl "https://api.postpeer.dev/v1/connect/twitter" \
  -H "x-access-key: YOUR_API_KEY"

With redirect:

curl "https://api.postpeer.dev/v1/connect/twitter?redirectUri=https://yourapp.com/connected" \
  -H "x-access-key: YOUR_API_KEY"

Response

{
  "url": "https://twitter.com/i/oauth2/authorize?response_type=code&client_id=..."
}

Redirect the user to the returned url. After they authorize on the platform, PostPeer's callback handles the token exchange and stores the connection. If redirectUri was provided, the user is redirected there after a successful connection.

How It Works

1. Your app calls GET /v1/connect/{platform} to get an OAuth URL
2. Redirect the user to that URL (or open it in a new tab)
3. The user authorizes on the platform (Twitter, YouTube, etc.)
4. The platform redirects to PostPeer's callback
5. PostPeer exchanges the code for tokens and stores them encrypted
6. If redirectUri was set, the user is redirected back to your app

Status Codes