> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blueberry.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Linking Social Accounts

> Connect your social media accounts to Blueberry

## Overview

Connect your social media accounts to Blueberry to start managing comments, DMs, and campaigns. Blueberry supports multiple platforms and allows you to manage multiple accounts per brand.

<Info>
  All account connections use secure OAuth authentication and can be disconnected at any time from
  your brand settings.
</Info>

## Supported Platforms

<CardGroup cols={2}>
  <Card title="Facebook Pages" icon="facebook">
    Manage page comments, posts, and direct messages with full Facebook Business Suite integration.
  </Card>

  <Card title="Instagram Business" icon="instagram">
    Track comments on posts and stories, manage DMs, and engage with your Instagram audience.
  </Card>

  <Card title="Ad Accounts" icon="meta">
    Connect Facebook and Instagram ad accounts to track ad performance and engagement metrics.
  </Card>
</CardGroup>

## Connecting Social Accounts

<Steps>
  <Step title="Navigate to Brand Settings">
    Navigate to **Brand > Setup** from the sidebar navigation.
  </Step>

  <Step title="Access Social Accounts">
    Scroll down to the **Social Accounts** section where you'll see all currently connected accounts.
  </Step>

  <Step title="Add New Account">
    Click the **Add Account** button to begin the connection process.
  </Step>

  <Step title="Authorize Access">
    You'll be redirected to the platform's authorization page. Grant Blueberry the requested
    permissions.

    <Warning>
      Ensure you have admin access to the pages or profiles you want to connect. Without admin
      permissions, the connection will fail.
    </Warning>
  </Step>

  <Step title="Select Pages/Profiles">
    Choose the specific pages or profiles you want to connect to Blueberry. You can select multiple accounts at once.

    <Check>
      Once connected, you'll see your account appear in the Social Accounts list with a green "Connected" status.
    </Check>
  </Step>
</Steps>

### Managing Connected Accounts

<AccordionGroup>
  <Accordion title="Disconnecting an Account" icon="unlink">
    To disconnect a social account: **(1)** Find the account in your Social Accounts list **(2)**
    Click the **menu icon** (three dots) on the right side **(3)** Select **Disconnect** from the
    dropdown menu **(4)** Confirm the disconnection in the dialog

    <Warning>
      Disconnecting an account will stop all data syncing, but historical data will be preserved.
    </Warning>
  </Accordion>

  <Accordion title="Re-authenticating Accounts" icon="rotate">
    If you need to re-authenticate an account:

    **(1)** Click the **Reconnect** button next to the account

    **(2)** Follow the OAuth flow to re-authorize access

    **(3)** Verify the connection is restored
  </Accordion>
</AccordionGroup>

## Connecting Ad Accounts

Ad accounts are connected during the normal account linking flow. Once connected, they allow Blueberry to create paid DM campaigns, send paid marketing messages, and track performance.

Paid marketing campaigns are optional: Blueberry never creates paid DM campaigns without user input.

<Steps>
  <Step title="Navigate to Ad Accounts">
    In the **Brand** section, scroll to the **Ad Accounts** area below Social Accounts.
  </Step>

  <Step title="Update Ad Selection">
    Click **Update ad account selection** to view available ad accounts from your connected Facebook
    account.
  </Step>

  <Step title="Select Ad Accounts">
    Check the boxes next to the ad accounts you want to connect. You can connect multiple ad accounts simultaneously.

    <Check>
      Successfully connected ad accounts will appear in your Ad Accounts list.
    </Check>
  </Step>
</Steps>

### Ad Account Features

<CardGroup cols={2}>
  <Card title="Ad Comment Monitoring" icon="comments">
    Track and respond to comments on ads directly from your unified inbox.
  </Card>

  <Card title="Campaign Integration" icon="bullseye">
    Link paid DM campaigns to specific ad accounts for targeted, automated outreach and conversion.
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection Issues" icon="triangle-exclamation">
    If you're having trouble connecting an account, try these solutions:

    <Steps titleSize="h3">
      <Step title="Check Permissions">
        Ensure you have **admin access** to the page or account you're trying to connect. Editor or lower roles cannot grant OAuth permissions.
      </Step>

      <Step title="Clear Browser Cache">
        Sometimes cached authentication tokens cause conflicts. Clear your browser cache or try in an incognito window.
      </Step>

      <Step title="Re-authenticate">
        Try disconnecting and reconnecting the account:

        **(1)** Disconnect the problematic account

        **(2)** Wait 1-2 minutes

        **(3)** Reconnect using fresh credentials
      </Step>

      <Step title="Review Facebook App Settings">
        Verify Blueberry has the necessary permissions in your Facebook Business Settings:

        **(1)** Go to Facebook Business Settings

        **(2)** Navigate to Apps → Blueberry

        **(3)** Ensure all required permissions are granted
      </Step>
    </Steps>

    <Warning>
      If issues persist after trying all steps above, contact Blueberry support with your account details and error messages.
    </Warning>
  </Accordion>

  <Accordion title="Multiple Page Selection Issues" icon="layer-group">
    If you're unable to select all desired pages during connection:

    <Steps titleSize="h3">
      <Step title="Verify Business Manager Access">
        Ensure all pages are in the same Business Manager for easier bulk selection.
      </Step>

      <Step title="Check Page Roles">
        You must have admin role on each page you want to connect.
      </Step>

      <Step title="Try Connecting Individually">
        If bulk selection fails, connect one page at a time for more reliable results.
      </Step>

      <Step title="Review Platform Limits">
        Some platforms limit the number of pages per OAuth token. Check if you've reached the limit.
      </Step>
    </Steps>

    <Note>
      You can always add more pages later by clicking "Add Account" again and selecting additional pages.
    </Note>
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Set Up Rules Engine" icon="wand-magic-sparkles" href="/comments/rules-engine">
    Automate comment responses with intelligent rules and workflows.
  </Card>

  <Card title="Create DM Campaigns" icon="paper-plane" href="/dms/campaigns/triggers">
    Set up automated DM campaigns with smart triggers.
  </Card>

  <Card title="Build Contact Segments" icon="users" href="/community/segments">
    Organize your audience into targeted segments for personalized engagement.
  </Card>

  <Card title="Configure Notifications" icon="bell" href="/notifications/overview">
    Stay updated with real-time notifications for important interactions.
  </Card>
</CardGroup>