Connect

Complete an OAuth connection

Exchanges an OAuth authorization code for tokens and connects the account to the specified profile. This endpoint requires a read-write API key.

post/v1/connect/{platform}

Request

  • Base URL: https://api.postzen.dev
  • URL: https://api.postzen.dev/v1/connect/{platform}
  • Auth: HTTP bearer

Request body

codestring required

OAuth authorization code returned by the platform.

statestring required

State returned by GET /v1/connect/{platform}.

profileIdstring required

PostZen profile id used when the connection was initiated.

Response

Account connected.

messagestring required
platform'twitter' | 'instagram' | 'tiktok' | 'linkedin' | 'facebook' | 'youtube' | 'threads' | 'pinterest' | 'bluesky' | 'telegram' required
profileIdstring required
status'connected' | 'needsReauth' required
missingScopesstring[]
connectedAccountCountinteger

Changes

No recorded changes to this operation across all 1 revision of this API.