Connect a channel

The two ways OpenQuok connects a social account today — OAuth redirect or credentials you paste in Add Channel.

5 min read

Connect your agent today

Draft from chat, review in your calendar, and publish only what you approve.

Where to start

A channel is one linked social account — one X profile, one LinkedIn Page, one Threads login.

The calendar, post editor, analytics, and templates all need at least one channel before they can do anything useful, so connecting is the first step in a new workspace.

On Home, click Add Channel. You can open the same picker from the channel row in the post editor.

Add Channel

Pick the network you want. OpenQuok picks the connection flow for that platform — you do not choose it yourself.

The two connection flows

OpenQuok currently supports two ways to connect. Which one you get depends on the platform, not on a setting in your workspace.

More flows later

Additional connection types — such as in-app setup dialogs or a browser extension for networks without a public API — may ship in future releases. When they do, this page will list them here.

The usual path: X, LinkedIn, Threads, TikTok, Instagram, Facebook Page, YouTube, and most other listed networks.

Click the network in Add Channel.
Your browser opens that platform’s sign-in or permission screen.
Approve access.
You land back in OpenQuok with the channel connected.

On OpenQuok Cloud, the developer apps are already registered — you only authorize your own account.

Some OAuth logins cover more than one destination. After you approve access, OpenQuok may ask one more question before the channel is ready:

Network	What you pick
Facebook Page	Which Page to publish to
Instagram Business	Which professional account linked to your Meta Page
YouTube	Which channel under your Google account
LinkedIn Page	Which company Page you administer

Finish that step before you schedule posts. Until you do, the channel shows Setup incomplete and cannot publish — click Complete setup on Home.

Some networks skip the browser redirect. OpenQuok asks for credentials in a short form inside Add Channel. There is no platform redirect and no developer app for you to register.

Today that includes Dev.to:

Platform	What you paste
Dev.to	API key from Dev.to settings

Tip

Use a platform-specific API key or app password when one exists, not your main login password. You can revoke those keys without locking yourself out of the account.

Credentials are stored encrypted. To change them later, open the channel menu on Home and click Refresh connection — paste a new key when the form appears.

Let a client connect their own account

You do not need their password. Next to Add Channel on Home, click the link icon (Send Invite Link to connect channel).

OpenQuok copies an invite link to your clipboard (valid for one hour). Send it to your client. They open it, sign in on the platform, and the channel appears in your workspace.

Invite links work only for OAuth redirect networks. Platforms that need credentials pasted in a form are excluded — connect those yourself or ask the client to sign in to OpenQuok and use Add Channel.

See Channel groups when you want client channels bundled and filtered together.

After you connect

The channel shows on Home with its avatar. Status badges on the channel grid summarize readiness:

Status	What it means
Ready	You can schedule posts to this channel
Setup incomplete	OAuth finished but you still need to pick a Page, channel, or account — click Complete setup
Refresh needed	The login expired or needs renewing — click Refresh connection
Disabled	You turned the channel off — use Enable channel in the menu to post again

Warning

You can connect more than one channel on the same network. Before you add another login on that platform, sign out of the service in your browser. Otherwise OpenQuok may reuse the account you connected last.

If connecting fails

Problem	What to try
Platform missing or always errors	See Cloud vs self-host below
Invalid state right after you approved	Start again in one fresh browser tab. Privacy extensions or extra tabs can drop the security token that ties the redirect to your session
Connected but posts fail immediately	The platform may require extra approval for API posting until a developer app is reviewed. Check the error on the failed post card
Blocked with a billing message	Plan cap, not a bug — see Cloud limits