Skip to main content
GET
Get a connect URL
This returns a URL and nothing more. The network shows its own consent screen to a person, so a channel cannot be connected without someone clicking through it.

Which networks it is for

It is for networks that sign in on their own consent page. The {integration} value is the network’s identifier, in lower case: youtube, threads, instagram-standalone. It is not always the display name.

After the sign-in

The person lands back in the PostQueen app, which finishes the connection. The sign-in state lives for one hour, so generate a new URL for a link that sat unused longer than that.
The new channel appears in List channels. Poll that, since this endpoint only hands out a URL.
To reconnect a channel whose token expired, pass its id as refresh. PostQueen reconnects that channel instead of adding a new one, and a reconnect does not count against the plan’s channel limit.

Authorizations

Authorization
string
header
required

Your API key from Connections > API Keys, or an OAuth access token (pos_...). Send it as it is, with no Bearer prefix.

Path Parameters

integration
string
required

The network's identifier, as in identifier from List channels, for example youtube or threads

Query Parameters

refresh
string

The id of an existing channel, to reconnect it instead of adding a new one. A reconnect does not count against the channel limit

Response

The URL to open

url
string

The network's sign-in URL

Last modified on September 24, 2026