Zernio API Docs

Appearance

Get pending OAuth data ​

Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.

Scope: This endpoint is used only for LinkedIn organizations and Snapchat profiles, where the selection list is too large to fit in URL params. WhatsApp, Facebook, Pinterest, Google Business and other platforms pass selection state directly via URL query params on the redirect (profileId, tempToken, step), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. /v1/connect/whatsapp/select-phone-number).

Token is one-time use and expires after 10 minutes. No authentication required.

GET /v1/connect/pending-data ​

Fetch pending OAuth data for headless mode using the pendingDataToken from the redirect URL.

Scope: This endpoint is used only for LinkedIn organizations and Snapchat profiles, where the selection list is too large to fit in URL params. WhatsApp, Facebook, Pinterest, Google Business and other platforms pass selection state directly via URL query params on the redirect (profileId, tempToken, step), no pending record is created, so this endpoint will return 404 for those flows. Use the platform-specific selection endpoint instead (e.g. /v1/connect/whatsapp/select-phone-number).

Token is one-time use and expires after 10 minutes. No authentication required.

Parameters ​

  • token (query, string) required — The pending data token from the OAuth redirect URL (pendingDataToken parameter)

Responses ​

200 — OAuth data fetched successfully

  • platform (string) — The platform (e.g., "linkedin")
  • profileId (string) — The Zernio profile ID
  • tempToken (string) — Temporary access token for the platform
  • refreshToken (string) — Refresh token (if available)
  • expiresIn (number) — Token expiry in seconds
  • userProfile (object) — User profile data (id, username, displayName, profilePicture)
  • selectionType (string) (enum: organizations, pages, boards, locations, profiles) — Type of selection data
  • organizations (array) — LinkedIn organizations (when selectionType is "organizations")

400 — Missing token parameter

  • error (string)
  • details (object)

404 — Token not found or expired

  • error (string)
  • details (object)