Get OAuth URL for a channel
Connect Channel (OAuth)
Generate an OAuth authorization URL for a given integration. Use this to connect a new social media channel. Only OAuth-based integrations are supported (integrations that require an external URL, such as Mastodon, are not available via this endpoint).
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.Refreshing an existing channel
After the redirect
The person lands back on yourFRONTEND_URL.
The channel appears in List Channels. That is the check worth
polling for, since this endpoint only ever hands out a URL.
Authorizations
Your PostQueen API key
Path Parameters
The integration identifier (e.g. x, linkedin, facebook, instagram, youtube, tiktok, reddit, etc.)
Query Parameters
Pass an existing integration ID to refresh its OAuth token instead of creating a new connection
Response
OAuth authorization URL
The OAuth authorization URL to redirect the user to