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

# Troubleshooting Common LinkInList Issues and Errors

> Step-by-step fixes for common LinkInList issues — channel connection errors, paused campaigns, inbox sync problems, and multi-channel setup.

Most issues in LinkInList fall into one of a few categories: account connection problems (LinkedIn, WhatsApp, Facebook, Instagram), campaign configuration issues, or sync and data glitches. This troubleshooting guide covers the most common ones with step-by-step fixes. Work through the relevant accordion below for your specific issue — if you've gone through the steps and still can't resolve it, the support team is available at [linkinlist.com/contact](https://linkinlist.com/contact).

<AccordionGroup>
  <Accordion title="My LinkedIn account shows 'Error' status — how do I fix it?">
    An **Error** status on your LinkedIn account in LinkInList means the platform has lost its active session with LinkedIn. This is almost always caused by one of three things:

    1. **You logged into LinkedIn from another browser or device** while LinkInList was running (the most common cause)
    2. **LinkedIn issued a security checkpoint** (email or phone verification) that needs to be resolved
    3. **Your LinkedIn password was changed** — either by you or as part of a security prompt from LinkedIn

    **To fix it:**

    <Steps>
      <Step title="Go to Account Settings">
        Navigate to **Settings → LinkedIn Accounts** in your LinkInList dashboard. Find the account showing the Error status.
      </Step>

      <Step title="Click 'Reconnect'">
        Click the **Reconnect** button next to the affected account. LinkInList will attempt to re-establish the session.
      </Step>

      <Step title="Complete Any Verification">
        If LinkedIn is requiring a security checkpoint (email or phone verification), you'll be prompted to complete it during the reconnect flow. Follow the prompts to verify your identity.
      </Step>

      <Step title="If the Error Persists">
        Try disconnecting the account entirely, waiting 30 minutes, and then reconnecting fresh. If the issue continues, contact [linkinlist.com/contact](https://linkinlist.com/contact) with your account ID.
      </Step>
    </Steps>

    <Warning>
      After reconnecting, do not log into LinkedIn from any browser or device other than through LinkInList. Doing so will break the session again.
    </Warning>
  </Accordion>

  <Accordion title="I connected a WhatsApp, Facebook, or Instagram account and it shows an error">
    If a WhatsApp, Facebook, or Instagram channel shows an error status in LinkInList, follow these steps:

    <Steps>
      <Step title="Go to Settings → Channels">
        Navigate to **Settings → Channels** in your LinkInList dashboard. Find the channel showing the error status.
      </Step>

      <Step title="Disconnect and Reconnect the Channel">
        Click **Disconnect** next to the affected channel, wait 30 seconds, then click **Connect** to re-authorize the connection. You will be redirected to the relevant platform to re-grant permissions.
      </Step>

      <Step title="Verify Your Account Type">
        Confirm you are connecting the correct account type:

        * **Facebook:** Must be a **Facebook Page** (not a personal profile). Ensure you have admin access to the Page.
        * **Instagram:** Must be an **Instagram Business account** linked to a Facebook Page. Personal and Creator accounts are not supported.
        * **WhatsApp:** Must be a **WhatsApp Business number**. Standard personal WhatsApp accounts are not supported.
      </Step>

      <Step title="Re-grant All Requested Permissions">
        During the reconnect flow, make sure to approve all requested permissions. Declining any permission during the OAuth flow will result in a partial connection that shows as an error.
      </Step>

      <Step title="If the Error Persists">
        Contact [linkinlist.com/contact](https://linkinlist.com/contact) with the channel type, your account email, and a screenshot of the error message. The support team can diagnose permission and API-level issues directly.
      </Step>
    </Steps>

    <Note>
      Facebook and Instagram connections are managed through Meta's business API. If your Facebook Page or Instagram account is restricted or under review by Meta, the connection will fail until the restriction is lifted on Meta's side.
    </Note>
  </Accordion>

  <Accordion title="My campaign is paused and I didn't pause it">
    LinkInList automatically pauses campaigns in several situations to protect your account or flag conditions that need your attention:

    * **Account session error** — if a connected account (LinkedIn, WhatsApp, Facebook, Instagram) shows an Error status, any campaigns running on that account are paused automatically
    * **A prospect replied** — if a prospect in an active sequence replies to a message, LinkInList pauses *that lead's sequence* to prevent a follow-up from sending over the top of a live conversation
    * **Daily limit reached** — if your account hits its configured daily limit mid-day, the campaign pauses until the next day's window opens
    * **LinkedIn security checkpoint** — if LinkedIn issues a checkpoint on your account, all campaigns on that account are paused

    **To diagnose and resume:**

    <Steps>
      <Step title="Check the Campaign Status Banner">
        Open the paused campaign — there should be a status banner at the top explaining why it was paused and what action (if any) is required.
      </Step>

      <Step title="Resolve the Underlying Issue">
        Fix the issue indicated (reconnect the account, complete a LinkedIn checkpoint, review replied leads, etc.) before resuming.
      </Step>

      <Step title="Resume the Campaign">
        Once the issue is resolved, click **Resume** on the campaign. LinkInList will pick up where it left off without re-sending any messages that were already sent.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Connection requests aren't being sent">
    If your campaign is active but connection requests aren't going out, check these in order:

    **1. Daily limit already reached**
    Check your campaign's activity log to see if today's limit has already been hit. If so, requests will resume the following day.

    **2. LinkedIn account has an Error status**
    Go to **Settings → LinkedIn Accounts** and confirm the connected account is showing as Active, not Error or Reconnecting.

    **3. Campaign audience is exhausted**
    If all leads in the campaign have already been sent a connection request, the campaign will show as active but have nothing to send. Add new leads or create a new campaign.

    **4. Leads are filtered out by deduplication**
    LinkInList automatically skips leads you've already connected with or recently contacted. Check your lead list for duplicates.

    **5. Warm-up schedule is still ramping**
    If your account is in the warm-up phase, daily limits are intentionally low. Check your warm-up schedule under **Settings → LinkedIn Accounts → Warm-Up Status**.

    <Tip>
      Enable the **Activity Log** view in your campaign to see a timestamped record of every action taken. This is the fastest way to diagnose why sends aren't happening.
    </Tip>
  </Accordion>

  <Accordion title="AI personalization messages look generic — how do I improve them?">
    Generic-looking AI messages are almost always a configuration issue, not a platform limitation. Here are the most common causes and fixes:

    **The personalization depth is set too low**
    Go to your campaign's AI settings and increase the **Personalization Depth** from Light to Standard or Deep. Light only uses role and company context; Standard and Deep pull in recent LinkedIn activity, company news, and mutual connections.

    **The leads don't have enough public activity to personalize from**
    If a prospect hasn't posted on LinkedIn recently and their company hasn't had any notable news, there may not be a strong personalization signal available. In this case, the AI falls back to role-based pain points. Consider filtering your lead list to prioritize more active prospects.

    **The AI prompt doesn't have enough context about your offering**
    Add a **Custom Context** note to your campaign settings explaining who you serve, what you do, and what angle you want the AI to take. The more specific this is, the more relevant the AI output will be.

    **You're reviewing a low-quality sample**
    Review at least 10–15 AI-generated messages before concluding the output is poor. A few generic messages in a batch of otherwise strong ones is normal — use the feedback thumbs-down on low-quality outputs to train the AI over time.
  </Accordion>

  <Accordion title="I'm not seeing replies in my Unified Inbox">
    If replies are arriving in LinkedIn or another channel but not appearing in your LinkInList Unified Inbox:

    <Steps>
      <Step title="Check Account Sync Status">
        Go to **Settings → LinkedIn Accounts** (for LinkedIn) or **Settings → Channels** (for other channels) and confirm the account is showing as **Synced**, not Syncing or Error. Inbox sync requires an active account session.
      </Step>

      <Step title="Trigger a Manual Sync">
        Click the **Sync Now** button next to the affected account. This forces an immediate inbox pull rather than waiting for the next scheduled sync cycle.
      </Step>

      <Step title="Check Your Inbox Filters">
        Make sure no filters are applied to your Unified Inbox that would hide the conversation. Clear all filters and search for the sender's name directly.
      </Step>

      <Step title="Check the Message Date">
        The Unified Inbox syncs messages from the point of account connection forward. Replies received before you connected your account to LinkInList won't appear.
      </Step>
    </Steps>

    <Note>
      Inbox sync typically runs every 5–10 minutes. If a reply was sent very recently, wait a few minutes and refresh before concluding it's missing.
    </Note>
  </Accordion>

  <Accordion title="LinkedIn sent me a security checkpoint (email or phone verification)">
    A LinkedIn security checkpoint is a request to verify your identity — it is not an account restriction, and it is resolvable. Follow these steps:

    <Steps>
      <Step title="Pause All Active Campaigns">
        Immediately pause all campaigns running on the affected account to prevent further activity while the checkpoint is unresolved.
      </Step>

      <Step title="Access the Verification Prompt">
        The checkpoint prompt will appear in the LinkInList account reconnect flow when you go to **Settings → LinkedIn Accounts** and click **Reconnect**. Do not try to complete the verification by logging into LinkedIn directly in a separate browser.
      </Step>

      <Step title="Complete the Verification">
        Follow the email or phone verification prompts as they appear. Enter the code LinkedIn sends to your registered email or phone number.
      </Step>

      <Step title="Wait 24–48 Hours Before Resuming">
        After completing the checkpoint, wait at least 24–48 hours before restarting campaigns. Resume at reduced daily limits (50% of your previous settings) for the first week.
      </Step>
    </Steps>

    <Tip>
      If you receive repeated checkpoints, it's a signal that your daily limits or message variation settings are too aggressive. Pull back your limits and review your message templates before resuming at higher volumes.
    </Tip>
  </Accordion>

  <Accordion title="My voice clone doesn't sound right">
    Voice clone quality depends heavily on the quality of your recording sample. Most issues come from one of these causes:

    **Background noise in the recording**
    Re-record in a quiet environment with no echo. Headset or lavalier microphones produce better results than laptop built-in mics.

    **Recording was too short**
    LinkInList recommends a minimum 60-second recording, but 90 seconds or more produces noticeably better results. Read from a prepared script that covers a natural range of sentences and tones.

    **Unnatural pacing in the source recording**
    Read at your natural speaking pace — not slower (which the AI can interpret as pauses) and not faster (which creates artifacts in the clone). Speak the way you'd speak on a normal phone call.

    **Voice notes reference content that doesn't fit the tone**
    If your voice clone sounds fine but the generated notes feel off, the issue may be the script, not the voice model. Review the voice note templates in your campaign settings and adjust the content and tone settings.

    To re-record your voice sample, go to **Settings → Voice Clone → Re-record Sample**.

    For full setup guidance, see the [Voice Notes feature guide](/features/voice-notes).
  </Accordion>

  <Accordion title="I imported a CSV but some leads weren't added">
    When leads are missing after a CSV import, the most common causes are:

    **Missing required fields**
    LinkInList requires at minimum a valid LinkedIn profile URL for each lead. Rows without a LinkedIn URL (or with a malformed URL) are skipped during import. Check your CSV for rows with blank or invalid LinkedIn URL columns.

    **Duplicate detection**
    LinkInList automatically deduplicates leads against your existing contacts. If a lead from your CSV already exists in your workspace (in any campaign or list), the duplicate row is skipped.

    **LinkedIn URL format issues**
    URLs must be in standard format: `https://www.linkedin.com/in/username`. Shortened URLs, Sales Navigator profile URLs, or URLs with tracking parameters may not parse correctly.

    **Row limit**
    CSV imports are limited to 10,000 rows per file. If your file exceeds this, split it into multiple imports.

    After import, go to **Campaigns → \[Campaign Name] → Import History** to see a log of which rows were imported, which were skipped, and why.
  </Accordion>

  <Accordion title="How do I contact LinkInList support?">
    The LinkInList support team is available through multiple channels:

    * **Help Center:** You're already here — search the docs for step-by-step guidance on any feature or issue.
    * **Live Chat:** Available in the bottom-right corner of your LinkInList dashboard during business hours (Monday–Friday, 9 AM–6 PM ET).
    * **Email / Support Ticket:** Submit a request at [linkinlist.com/contact](https://linkinlist.com/contact). Include your account email, a description of the issue, and any relevant screenshots or error messages. The team typically responds within one business day.

    <Tip>
      When contacting support, include your campaign ID (found in the URL when viewing a campaign) and your account email. This helps the support team pull up your account instantly and reduces back-and-forth.
    </Tip>
  </Accordion>

  <Accordion title="My intent scores aren't updating">
    Buying intent scores in LinkInList are calculated from engagement signals — profile views of your leads' profiles, connection acceptance, message reply behavior, and link clicks (if applicable). If scores appear stale or aren't updating:

    **Check when scores were last calculated**
    Intent scores update on a 24-hour cycle by default. If you're checking scores within a few hours of a prospect taking action, the score may not have recalculated yet.

    **Verify the account session is active**
    Intent scoring requires an active account session to pull engagement signals. If your LinkedIn account shows an Error or Disconnected status, scoring will pause until the account is reconnected.

    **The lead hasn't taken any new actions**
    Intent scores only change when a lead takes an action (views your profile, replies, clicks a link, accepts a connection). A score that's held steady simply means the lead hasn't done anything new that would shift their score.

    **Manually trigger a rescore**
    Go to **Campaigns → \[Campaign Name] → Leads**, select the lead in question, and click **Rescore**. This forces an immediate recalculation based on the latest available signals.

    <Info>
      Intent score tiers: **Hot (80+)** — strong engagement signals, prioritize for direct follow-up. **Warm (50–79)** — moderate signals, continue nurturing. **Cold (below 50)** — low engagement, consider adjusting your message angle or deprioritizing for now.
    </Info>
  </Accordion>
</AccordionGroup>