Appearance
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.
GET /v1/connect/{platform}
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.
Parameters
platform(path, string) required — Social media platform to connectprofileId(query, string) required — Your Zernio profile ID (get from /v1/profiles)redirect_url(query, string) — 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...headless(query, boolean) — When 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.
Responses
200 — OAuth authorization URL to redirect user to
authUrl(string) — URL to redirect your user to for OAuth authorizationstate(string) — State parameter for security (handled automatically)
400 — Missing/invalid parameters (e.g., invalid profileId format)
401
402
403 — No access to profile, or BYOK required for AppSumo Twitter
404 — Profile not found