Get OAuth connect URL
Initiate an OAuth connection flow. Returns an authUrl to redirect the user to. Standard flow: Zernio hosts the selection UI, then redirects to your redirect_url. Headless mode (headless=true): user is redirected to your redirect_url with OAuth data for custom UI. Use the platform-specific selection endpoints to complete.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Social media platform to connect
"facebook" | "instagram" | "linkedin" | "twitter" | "tiktok" | "youtube" | "threads" | "reddit" | "pinterest" | "bluesky" | "googlebusiness" | "telegram" | "snapchat"Query Parameters
Your Zernio profile ID (get from /v1/profiles)
Your custom redirect URL after connection completes. Standard mode appends ?connected={platform}&profileId=X&accountId=Y&username=Z. Headless mode appends OAuth data params for platforms requiring selection (e.g. LinkedIn orgs, Facebook pages). If no selection is needed, the account is created directly and the redirect includes accountId.
uriWhen true, the user is redirected to your redirect_url with raw OAuth data (code, state) instead of Zernio's default account selection UI. Use this to build a custom connect experience.
falseResponse Body
application/json
application/json
curl -X GET "https://zernio.com/api/v1/connect/facebook?profileId=string"{
"authUrl": "https://www.facebook.com/v21.0/dialog/oauth?client_id=...",
"state": "user123-profile456-1234567890-https://yourdomain.com/callback"
}{
"error": "Unauthorized"
}