Connect

Create an OAuth connect URL

Initiates an OAuth connection flow and returns an authorization URL to redirect the user to. The OAuth state expires after 10 minutes. This endpoint requires a read-write API key.

For bluesky, the returned authUrl is a PostZen-hosted page where the user enters their Bluesky handle and app password (no developer app or OAuth redirect is required); the connection completes when they submit that form.

For telegram, the returned authUrl is a PostZen-hosted page that issues a short-lived access code (there is no OAuth grant and no Telegram authorization screen); the connection completes when the user adds @PostZenScheduleBot as an administrator of a channel or group and sends that code to the bot.

get/v1/connect/{platform}

Request

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

Query parameters

profileIdstring required

PostZen profile id to attach the connected account to.

redirectUrlstring uri

Custom URL PostZen redirects to after the connection completes.

Response

OAuth URL created.

authUrlstring uri required

URL to redirect the user to for platform authorization.

statestring required

OAuth state parameter generated by PostZen.

Changes

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