Connections

A connection is an authenticated link between your workspace and one account on a platform. You can have multiple connections per platform — for example, three different Reddit accounts or two Telegram bots. Each connection is kept encrypted and can only post on behalf of that account.

Screenshot pending

/help/connections/open_connections_menu.png

Workspace sidebar with the Connections menu item highlighted

See docs/help-screenshot-manifest.md for capture instructions.

Screenshot pending

/help/connections/connections_grid.png

Connections page showing a grid of connection cards, each with a coloured accent rail, connector chip, status pill, display title, member/karma stat, posts sent, and per-card ⋯ menu

See docs/help-screenshot-manifest.md for capture instructions.

Adding a connection

Navigate to Connections

Click Connections in the top navigation bar.

Click Add connection

A dialog opens showing all available connectors. Click the platform you want to connect.

Fill in the credential form

Each platform has its own form (see the per-platform guides below). Follow the on-screen instructions, give the connection a memorable label (e.g., "Personal Telegram — Tech channel"), and click Save.

Connection is verified

AI Boost Post calls the platform immediately to check the credentials. A green Active badge confirms success.

Screenshot pending

/help/connections/add_connection_dialog.png

Add Connection modal showing categories in coloured panels (Messaging in sky, Social in purple, Blogging in amber, Community in emerald, Forum in rose, Owned media in indigo, Email & CRM in teal) with connectable rows in each

See docs/help-screenshot-manifest.md for capture instructions.

Screenshot pending

/help/connections/credential_form_example.png

A connector-specific credential form (Telegram) showing setup instructions box, Bot token input, Channel ID input, and Save button

See docs/help-screenshot-manifest.md for capture instructions.

Connection status

Status	Meaning
✅ Active	The connection is working. Promotions will be posted normally.
⚠ Needs reconnect	The credentials have expired (common with OAuth tokens). Click the three-dot menu → Reconnect to go through the auth flow again.
❌ Revoked	The platform has revoked access (e.g., you removed the app from your Reddit account). Re-add the connection from scratch.

Reconnect banner. When one or more connections need attention, a banner appears at the top of every page. Clicking it takes you directly to the Connections page where you can reconnect the affected accounts.

Screenshot pending

/help/connections/reconnect_banner.png

Top-of-page amber alert banner reading N connections need reconnecting — click Refresh all on the Connections page to reconnect them, with Fix now button and dismiss X

See docs/help-screenshot-manifest.md for capture instructions.

Refreshing a connection

On any connection card, open the three-dot menu (⋯) and click Refresh connection. AI Boost Post makes a lightweight call to the platform to verify the credentials are still valid and re-pulls display fields (member counts, account name, etc.). The card updates within a few seconds with the result. Use this whenever a card shows an error or when you want to force a fresh check.

Screenshot pending

/help/connections/refresh_connection_menu.png

A single connection card with the ⋯ menu open showing Refresh connection, Send test post, Edit name, Edit settings, and Disconnect options

See docs/help-screenshot-manifest.md for capture instructions.

Screenshot pending

/help/connections/refresh_all_button.png

Connections page header with a Refresh all button in the top toolbar next to Add Connection, showing the button in mid-pending state with a spinning icon

See docs/help-screenshot-manifest.md for capture instructions.

Per-platform setup guides

Bot token

Message @BotFather on Telegram and send /newbot. Follow the prompts and copy the token it gives you.
Paste the bot token into the connection form.
Add the bot to your channel or group as an Administrator with "Post Messages" permission.
Paste the channel handle (e.g. @mychannel) or numeric chat ID (e.g. -1001234567890) into the form and click Save.

Discord

Webhook URL

In your Discord server, go to a channel’s settings → Integrations → Webhooks.
Click New Webhook, give it a name and optionally an avatar, then click Copy Webhook URL.
Paste the URL into the AI Boost Post connection form and click Save.

OAuth 2.0

Click Connect and you will be redirected to Reddit.
Log in to the Reddit account you want to post from and click Allow.
You are returned to AI Boost Post with the connection active.

Bluesky

App password

In Bluesky, go to Settings → Privacy & Security → App Passwords and create a new app password.
Enter your Bluesky handle (e.g. alice.bsky.social) and the app password into the form and click Save.

Mastodon

OAuth 2.0 (per instance)

Enter your Mastodon instance URL (e.g. mastodon.social) in the first field.
Click Connect — you will be redirected to that instance to authorize.
Grant access and you are returned to AI Boost Post.

Threads

OAuth 2.0 (Meta)

Click Connect. You are redirected to Meta / Threads to authorize.
Log in with the Instagram account linked to your Threads profile and click Allow.

Tumblr

OAuth 1.0a

Click Connect. You are redirected to Tumblr to authorize.
Log in and click Allow.

Dev.to

API key

In Dev.to, go to Settings → Extensions → DEV API Keys and generate a new key.
Paste the key into the connection form and click Save.

Hashnode

Personal Access Token

In Hashnode, go to Account Settings → Developer → Personal Access Tokens and generate a token.
Paste the token into the connection form and click Save.

Medium

Integration token

In Medium, go to Settings → Security and Apps → Integration tokens and generate a token.
Paste the token into the connection form and click Save.

Never share your connection credentials. Bot tokens, OAuth tokens, and API keys are stored encrypted and are never shown in plain text after setup. If you suspect a credential has been compromised, disconnect the connection and create a new one.