workflow · how to

Connect social accounts

Follow the connect social accounts workflow in Slack.

Goal

Connect, reconnect, refresh, and disconnect social profiles for the active brand so Slash Social can publish and report on the right platforms.

When to use this

Use this workflow when you need to:

  • Add a new social profile to a brand
  • Reconnect after expired, disconnected, or reauthorization-required status
  • Move an account between brands in your org
  • Pause publishing without deleting a connection
  • Manage child pages or locations on platforms that expose targets
  • Disconnect a profile you no longer use

Account management lives in Settings and App Home. OAuth sign-in happens in your browser; Slack shows progress in modals and refreshes lists when the connection completes.

Before you begin

Confirm all of the following:

  • Slash Social is installed in your Slack workspace
  • You have created a brand
  • You can manage brand or org settings
  • The active brand in App Home matches the brand that should own the new or reconnected profile

Check account health in Settings before you schedule or publish. Healthy status means the profile is ready for publishing workflows.

Steps

Open connected accounts

  1. Type /social, choose Settings, then Connected Accounts.

    You can also choose Connect accounts from App Home setup when no profiles are connected yet. That path opens account management with the same org and brand context and applies limit and permission checks.

  2. Confirm the active brand shown in the modal matches the account you want to add or edit.

Connect or reconnect a profile

  1. Choose the platform and start the connection flow.
  2. Complete the platform sign-in and permission screen in your browser.
  3. Return to Slack when the waiting modal updates or App Home refreshes.

For a reconnect, choose Reconnect when health shows expired or disconnected status, or when Slack shows scopes missing or reauthorization-required status. Slash Social may refresh eligible tokens in the background, but manual reconnect is required when health flags a problem.

Self-serve plans support Instagram, TikTok, X, Facebook Pages, LinkedIn, YouTube, Threads, Pinterest, and Bluesky. The Free plan does not include X. See Platform support for plan details.

Manage connected accounts

From the connected accounts modal you can:

  • Reconnect: restore OAuth when health is expired or disconnected
  • Change brand: move an account to another brand in the org (requires appropriate access)
  • Toggle active: pause publishing for a profile without deleting the connection
  • Manage targets: choose child pages or locations on platforms that expose them
  • Disconnect: remove the link between the profile and the brand

Each successful change records audit history and refreshes the account list in the modal.

Handle OAuth return errors

If the browser connection page shows an error, read the message on that page, fix platform permissions or account access, and start Reconnect again from Slack. Do not leave the flow half-finished; return to the connected accounts modal to confirm status.

Confirm it worked

  • The profile appears under the correct brand in the connected accounts list.
  • Account health in Settings shows a healthy, ready status (not expired, disconnected, scopes missing, or reauthorization-required).
  • App Home account health cards align with the modal list.
  • Toggle active, target changes, and brand moves refresh the list without stale rows.

Troubleshooting

OAuth fails in the browser: Read the error on the connection page. Confirm you approved the correct Facebook Page, Instagram professional account, or other platform entity. Reconnect from Slack after fixing platform-side access.

Expired or disconnected token: Use Reconnect from the connected accounts modal. For step-by-step token recovery, see Account connection expired.

Wrong brand on the account: Use Change brand if you have access, or ask an org admin to move it. Always verify the active brand before connecting a new profile.

Connection limit or permission blocked: Slack shows feedback in the modal when limits or permissions block the action. Resolve the limit or role issue, then retry.

Modal does not refresh after browser OAuth: Wait for the waiting modal to update. If it stalls, close and reopen Connected Accounts from Settings or App Home.