Skip to main content
GET
Get OAuth URL for a channel
This returns the URL to send a person to. It does not connect anything on its own, because the network shows a consent screen to a human and then redirects back.
There is no headless way to add a channel, and that is the network’s rule rather than ours.

Two ways this returns 400

Both arrive before any request reaches the network, so they are quick to tell apart from a real OAuth failure.
Mastodon and other self-hosted networks are not connectable through this endpoint. They need an instance URL, and the only place that asks for one is Add Channel in the app. That is what the second message above means in practice.

Refreshing an existing channel

Pass ?refresh=<integration-id> and the flow reconnects that channel instead of adding a new one. Use it when a channel has gone red because the network expired its token rather than because someone revoked access.

After the redirect

The person lands back on your FRONTEND_URL.
The channel appears in List Channels. That is the check worth polling for, since this endpoint only ever hands out a URL.

Authorizations

Authorization
string
header
required

Your PostQueen API key

Path Parameters

integration
string
required

The integration identifier (e.g. x, linkedin, facebook, instagram, youtube, tiktok, reddit, etc.)

Query Parameters

refresh
string

Pass an existing integration ID to refresh its OAuth token instead of creating a new connection

Response

OAuth authorization URL

url
string

The OAuth authorization URL to redirect the user to